Appearance
Linux 客户端使用
Linux 客户端适合服务器、NAS、软路由等不需要图形界面的环境。当前提供 x64 和 arm64 两种架构，下载后直接运行 zosenlink-core 即可。
选择版本
打开官网的 客户端下载 页面，选择 Linux 客户端。
| 版本 | 适用环境 |
|---|---|
| Linux x64 | Intel/AMD 服务器、常见云服务器。 |
| Linux arm64 | ARM 服务器、部分 NAS、树莓派或 ARM 云服务器。 |
下载需要先登录账号。如果页面提示登录，请先登录控制台。
创建客户端密钥
登录控制台，进入左侧菜单的 客户端 页面，点击 创建客户端。
创建成功后，在客户端列表中复制 连接密钥。Linux 客户端启动时需要使用这个密钥完成绑定。
密钥请妥善保管
连接密钥相当于这台客户端的身份凭证。不要写入公开仓库，也不要发给无关人员。
安装到服务器
把下载的压缩包上传到服务器后执行：
bash
mkdir -p /opt/zosenlink
tar -xzf zosenlink-client-*-linux-*.tar.gz -C /opt/zosenlink
chmod +x /opt/zosenlink/zosenlink-core前台启动
前台启动适合第一次验证，终端关闭后程序也会退出。
bash
/opt/zosenlink/zosenlink-core '你的客户端密钥'启动后回到控制台查看客户端状态。如果显示 在线，说明客户端已经连接成功。
nohup 后台启动
如果只是临时后台运行，可以使用 nohup：
bash
mkdir -p /var/log/zosenlink
nohup /opt/zosenlink/zosenlink-core '你的客户端密钥' >> /var/log/zosenlink/zosenlink-core.log 2>&1 &
echo $! > /opt/zosenlink/zosenlink-core.pid查看日志：
bash
tail -f /var/log/zosenlink/zosenlink-core.log停止进程：
bash
kill "$(cat /opt/zosenlink/zosenlink-core.pid)"systemd 常驻运行
生产环境推荐使用 systemd，这样服务器重启后客户端会自动启动。
先保存客户端密钥：
bash
mkdir -p /etc/zosenlink
printf 'ACTIVATION_KEY=%s\n' '你的客户端密钥' > /etc/zosenlink/zosenlink-core.env
chmod 600 /etc/zosenlink/zosenlink-core.env创建服务文件：
bash
cat >/etc/systemd/system/zosenlink-core.service <<'EOF'
[Unit]
Description=ZosenLink Core
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
WorkingDirectory=/opt/zosenlink
EnvironmentFile=/etc/zosenlink/zosenlink-core.env
ExecStart=/opt/zosenlink/zosenlink-core ${ACTIVATION_KEY}
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
EOF启动并设置开机自启：
bash
systemctl daemon-reload
systemctl enable --now zosenlink-core查看状态：
bash
systemctl status zosenlink-core查看日志：
bash
journalctl -u zosenlink-core -f重启服务：
bash
systemctl restart zosenlink-core创建映射通道
客户端在线后，进入控制台的 通道 页面创建通道。
| 字段 | 填写建议 |
|---|---|
| 客户端 | 选择这台 Linux 客户端。 |
| 通道名称 | 写一个容易识别的名称，例如 ssh、mysql、web。 |
| 本地地址 | 服务就在本机时填写 127.0.0.1；服务在局域网其他机器时填写对应内网 IP。 |
| 本地端口 | SSH 通常是 22，MySQL 通常是 3306，网站服务按实际端口填写。 |
创建完成后复制 访问地址，即可从公网访问本地服务。
更新客户端
下载新版本后替换二进制即可：
bash
systemctl stop zosenlink-core
tar -xzf zosenlink-client-*-linux-*.tar.gz -C /opt/zosenlink
chmod +x /opt/zosenlink/zosenlink-core
systemctl start zosenlink-core