配置系统服务

本章主要讲述如何将 MSST-Net 客户端核心配置为系统服务。

什么是系统服务

系统服务是一种后台运行机制。

将 MSST-Net 客户端核心配置为系统服务后，可以在后台持续运行，并支持开机自动启动。

---

为什么推荐配置系统服务

推荐将客户端核心配置为系统服务，主要原因如下：

• 开机自动运行
• 后台持续运行
• 提高运行稳定性
• 支持自动恢复

对于长期接入 MSST-Net 的设备，建议进行配置。

---

Windows

使用客户端安装器时，系统服务（服务名 msst-net）会自动创建并启动，无需手动配置。

如果需要手动配置，请使用系统服务管理工具完成注册。

配置完成后，可通过系统服务管理器启动或停止服务。

---

Linux（systemd）

Linux 平台推荐使用 systemd 管理客户端核心。

使用客户端安装器时，systemd 服务（单元名 msst-net）会自动创建并启用，无需手动配置。

如需手动配置，请参考以下内容。

创建服务文件

服务文件路径：

/etc/systemd/system/msst-net.service

以下为安全加固版配置示例，适用于以非 root 用户身份运行客户端核心的场景（请根据实际安装路径和用户名修改）：

[Unit]
Description=MSST-Net Client Core
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=YOUR_USERNAME
ExecStart=/usr/bin/msst-net-client-core
Restart=on-failure
RestartSec=5
RuntimeDirectory=msst-net
RuntimeDirectoryMode=0750
AmbientCapabilities=CAP_NET_ADMIN
NoNewPrivileges=true

[Install]
WantedBy=multi-user.target

将 YOUR_USERNAME 替换为实际运行客户端的用户名。 若核心安装在其他路径，请相应修改 ExecStart。

重新加载 systemd 配置

sudo systemctl daemon-reload

启用服务（开机自启）

sudo systemctl enable msst-net

启动服务

sudo systemctl start msst-net

查看状态

sudo systemctl status msst-net

查看日志

sudo journalctl -u msst-net -f

macOS（launchd）

macOS 平台推荐使用 launchd 管理客户端核心。

使用客户端安装器

使用客户端安装器时，会自动在系统级别创建 LaunchDaemon，开机即自动启动，无需用户登录：

/Library/LaunchDaemons/net.msst.client.plist

管理命令：

# 停止
sudo launchctl unload /Library/LaunchDaemons/net.msst.client.plist

# 启动
sudo launchctl load -w /Library/LaunchDaemons/net.msst.client.plist

手动配置（用户级 LaunchAgent）

如需以当前登录用户身份运行，可手动创建用户级 LaunchAgent：

~/Library/LaunchAgents/net.msst.client.plist

示例配置文件内容（请根据实际安装路径修改）：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>net.msst.client</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/msst-net/msst-net-client-core-macos-arm64</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

加载服务

launchctl load ~/Library/LaunchAgents/net.msst.client.plist

卸载服务

launchctl unload ~/Library/LaunchAgents/net.msst.client.plist

服务管理

启动服务

启动客户端核心服务。

停止服务

停止客户端核心服务。

重启服务

重新启动客户端核心服务。

查看状态

查看当前服务运行状态。

查看日志

建议定期查看运行日志，以便排查问题。

注意事项

客户端控制器通常不建议配置为系统服务。

如需开机自动打开控制器，请使用系统自带的开机启动功能。

下一步

完成系统服务配置后，建议继续：

• 完成接入认证
• 选择接入方式

详见：

《新手教程》