常用运维命令

本文汇总被控节点与主控端的日常运维命令，可收藏备查。

一、被控节点：配置同步服务

节点通过 ws_config_client.service 与主控保持配置同步，这是最常用的服务。

# 启动
systemctl start ws_config_client.service

# 停止
systemctl stop ws_config_client.service

# 重启（修改主控地址或配置后执行）
systemctl restart ws_config_client.service

# 查看运行状态
systemctl status ws_config_client.service

# 实时查看日志（Ctrl + C 退出）
journalctl -u ws_config_client.service -f

# 查看最近 200 行日志
journalctl -u ws_config_client.service -n 200

# 查看开机自启是否启用
systemctl is-enabled ws_config_client.service

二、被控节点：OpenResty（Nginx）管理

节点使用 OpenResty 承载流量转发。

# 检查配置语法（改动配置后建议先检查再重载）
/usr/local/openresty/nginx/sbin/nginx -t

# 启动
/usr/local/openresty/nginx/sbin/nginx

# 停止
/usr/local/openresty/nginx/sbin/nginx -s stop

# 重载配置（不中断连接）
/usr/local/openresty/nginx/sbin/nginx -s reload

三、被控节点：配置与日志位置

用途	路径
节点主目录	/opt/gincdn
节点配置	/opt/gincdn/conf/node_config.conf
初始化脚本	/opt/gincdn/client.sh
Nginx 配置	/opt/gincdn/nginx/conf
WAF 相关	/opt/gincdn/waf
站点页面目录	/opt/gincdn/html

查看当前主控地址：

grep MASTER_API_URL /opt/gincdn/conf/node_config.conf

四、被控节点：安装与更新程序

安装包自带的帮助（3 个参数）：

用法:
  gincdn-install --master-url <url>           完整部署并指定主控地址
  gincdn-install --update-master-url <url>    更新主控地址
  gincdn-install --help                       显示此帮助信息

更新包的帮助多出一项 --update（4 个参数）：

用法:
  gincdn-install --master-url <url>           完整部署并指定主控地址
  gincdn-install --update-master-url <url>    更新主控地址
  gincdn-install --update                     更新节点组件（下载更新包并保留站点/缓存/日志数据）
  gincdn-install --help                       显示此帮助信息

常用调用示例：

gincdn-install --master-url http://192.168.1.100:8080
gincdn-install --update-master-url http://192.168.1.200:8080
gincdn-install --update

对应的下载地址：

用途	地址
首次安装	https://www.gincdn.cn/download/ubuntu/gincdn-install
节点更新	https://www.gincdn.cn/download/update/ubuntu/gincdn-install

五、主控端：日常维护

主控端通过宝塔面板「Go 项目」管理进程，常见操作：

操作	位置
启动 / 停止 / 重启主控	宝塔面板 → 网站 → Go 项目
查看主控运行日志	宝塔面板 → Go 项目 → 日志
数据库备份	宝塔面板 → 数据库 → 备份
查看端口放行情况	宝塔面板 → 安全

主控程序本身的常用操作（在源码目录下执行）：

# 查看主控进程是否在运行
ps -ef | grep gincdn

# 查看主控监听端口
netstat -lntp | grep 8080

六、连通性排查命令

节点连不上主控时，用这些命令逐层确认：

# 1. 主控端口是否可达（替换为你的主控地址与端口）
telnet 主控IP 8080

# 2. 域名解析是否正确
ping 你的主控域名

# 3. 本机出网是否正常
curl -I https://www.gincdn.cn

# 4. 本机防火墙状态
systemctl status firewalld    # CentOS
ufw status                    # Ubuntu

相关文档

• 被控节点安装（Ubuntu）
• 被控节点更新
• 常见问题排查