服务器,一行安装。
自动识别 Linux amd64 / arm64,下载并校验 0.2.0 发行包,初始化数据,配置 systemd 开机启动和异常重启,最后检查服务健康状态。
1. 在服务器执行
curl -fsSL https://carrier.anxhub.com/docs/carrier-mcp-server/install.sh -o /tmp/carrier-mcp-install.sh && sudo bash /tmp/carrier-mcp-install.sh
适用于运行 systemd 的 Linux 服务器,需要 sudo 或 root。无需 Go、Node.js 或外部数据库。安装器自动检查依赖和 CA 证书,通过 apt-get(Ubuntu/Debian)、dnf/yum(RHEL 系列)或 zypper(SUSE)安装缺失软件包,已有依赖直接跳过。需要可访问系统软件源;安装失败会停止。主机必须已经运行 systemd,安装器不会转换系统初始化方式。root 用户可去掉 sudo。上面用于获取脚本的命令本身需要 curl;若没有 curl 但有 wget,可用下面的方式:
wget -O /tmp/carrier-mcp-install.sh https://carrier.anxhub.com/docs/carrier-mcp-server/install.sh && sudo bash /tmp/carrier-mcp-install.shcurl 和 wget 都没有时,可从本页下载脚本,通过 SSH/SCP 上传服务器后运行 sudo bash carrier-mcp-install.sh,脚本会自动补齐 curl。执行脚本需要 Bash。
只查看安装计划:在命令末尾加 --dry-run。缺依赖时只展示待安装软件包;依赖齐全时下载并校验程序、展示服务配置,不安装依赖或服务。查看安装脚本
2. 从自己电脑打开控制台
默认监听服务器的 127.0.0.1:7331。在自己的电脑执行以下命令,替换服务器用户和地址:
ssh -N -L 7331:127.0.0.1:7331 用户@服务器地址
保持 SSH 连接,浏览器打开 http://127.0.0.1:7331。服务器管理员在服务器读取登录凭据:
sudo cat /var/lib/carrier-mcp/admin.token
凭据用于管理页登录,请妥善保管。AI 客户端使用管理页单独创建的限权凭据,通过 http://127.0.0.1:7331/mcp 连接;SSH 转发需保持开启。
3. 团队使用 HTTPS
首次安装时准备域名和证书,将第一步命令替换为以下命令。修改示例域名和证书路径:
curl -fsSL https://carrier.anxhub.com/docs/carrier-mcp-server/install.sh -o /tmp/carrier-mcp-install.sh && sudo bash /tmp/carrier-mcp-install.sh --port 7331 --public-url https://mcp.example.com:7331 --tls-cert /path/fullchain.pem --tls-key /path/privkey.pem
此时监听 0.0.0.0:7331。管理页为 https://mcp.example.com:7331,MCP 为 https://mcp.example.com:7331/mcp。域名解析到服务器,按需要开放安全组和防火墙的 7331 端口。私有 CA 可加 --ca-file /path/root-ca.pem,客户端也需信任该 CA。证书续期后需更新 /etc/carrier-mcp 下的证书并重启服务。
4. 状态与维护
sudo systemctl status carrier-mcp --no-pager
sudo journalctl -u carrier-mcp -n 50
sudo systemctl restart carrier-mcp
sudo systemctl stop carrier-mcp
sudo -u carrier-mcp /usr/local/bin/carrier-mcp mcp doctor --data /var/lib/carrier-mcp
程序:/usr/local/lib/carrier-mcp;数据:/var/lib/carrier-mcp;证书:/etc/carrier-mcp。备份时先停止服务,完整备份数据目录(包含数据库与加密密钥),再启动。
5. 重复安装与故障
当前是一键首次安装,不是升级器。发现已有服务、数据或同名用户时会停止并保留原文件;不要删除数据重新安装。健康检查失败时会停止服务并禁用自启,保留现场,按日志排查后再启用。默认端口占用可在首次安装时加 --port 7441。
已校验发行包及安装预览。各 Linux 发行版的完整 systemd 安装、重启恢复与外部 HTTPS 访问仍需在目标服务器验收。