需在无GUI服务器上部署Fitten Code:确认systemctl get-default为multi-user.target;下载解压v1.8.2二进制包至/opt/fc-server;创建fitten用户并授权;配置systemd服务监听0.0.0.0:3000;开放防火墙3000端口;浏览器访问IP:3000即可使用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在无图形界面的Linux服务器上部署Fitten Code,需绕过GUI依赖、启用Web访问入口、配置权限与端口策略,最终通过浏览器直连编辑器界面。该过程不安装Xorg或Wayland,不启动显示管理器,所有操作均在SSH终端完成,适用于Ubuntu 22.04/24.04、CentOS 8+/Rocky 9等主流发行版。
确认系统基础状态
执行 systemctl get-default 查看当前默认目标,输出必须为 multi-user.target;若为 graphical.target,说明已有桌面环境残留,需先执行 sudo systemctl set-default multi-user.target 并重启,否则后续服务可能冲突。
运行 lsb_release -is 和 lsb_release -rs 获取发行版ID与版本号,【Ubuntu必须使用apt,RHEL系必须用dnf,混用会导致元包解析失败】。
检查防火墙状态:sudo ufw status(Ubuntu)或 sudo firewall-cmd --state(RHEL系),若为active,记下当前开放端口范围,避免Fitten Code端口被拦截。
下载并解压Fitten Code Server二进制包
进入临时目录:cd /tmp。
执行下载命令:curl -L https://github.com/fittencode/fc-server/releases/download/v1.8.2/fc-server-linux-amd64.tar.gz -o fc.tar.gz。注意v1.8.2为当前最新稳定版,若链接失效,请访问GitHub releases页手动复制最新amd64或arm64包URL。
创建安装目录并解压:sudo mkdir -p /opt/fc-server && sudo tar -zxvf fc.tar.gz -C /opt/fc-server --strip-components=1。这一步会把可执行文件直接释放到 /opt/fc-server 根下,不含多余子目录层级。
赋予执行权限:sudo chmod +x /opt/fc-server/fc-server。
配置运行参数与用户权限
新建专用运行用户,禁止root直接启动:sudo useradd -r -s /bin/false fitten。该用户无登录shell、无家目录,仅用于隔离进程权限。
将二进制文件属主设为该用户:sudo chown fitten:fitten /opt/fc-server/fc-server。
创建配置目录并授权:sudo mkdir -p /var/lib/fc-server && sudo chown fitten:fitten /var/lib/fc-server。Fitten Code默认将工作区、插件、日志写入此路径,【若跳过此步,首次启动时会因权限拒绝创建目录而静默失败】。
切换至fitten用户测试启动:sudo -u fitten /opt/fc-server/fc-server --host 0.0.0.0 --port 3000 --data-dir /var/lib/fc-server。看到“Server listening on http://0.0.0.0:3000”即表示基础运行通路已通。
注册为systemd服务并开机自启
创建服务定义文件:sudo nano /etc/systemd/system/fc-server.service。
填入以下内容:
[Unit]
Description=Fitten Code Server
After=network.target
[Service]
Type=simple
User=fitten
Group=fitten
WorkingDirectory=/var/lib/fc-server
ExecStart=/opt/fc-server/fc-server --host 0.0.0.0 --port 3000 --data-dir /var/lib/fc-server
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target
重载systemd配置:sudo systemctl daemon-reload。
启用并启动服务:sudo systemctl enable --now fc-server.service。
验证状态:sudo systemctl status fc-server.service,确认Active: active (running)且无Failed行。
开放端口并验证远程访问
Ubuntu用户执行:sudo ufw allow 3000;RHEL系执行:sudo firewall-cmd --permanent --add-port=3000/tcp && sudo firewall-cmd --reload。
检查端口监听:ss -tuln | grep ':3000',应返回类似 tcp LISTEN 0 128 *:3000 *:* 的行。
从本地浏览器访问 http://[服务器IP]:3000,页面加载出Fitten Code编辑器界面即成功。若无法访问,检查云服务器安全组是否放行3000端口——这一步常被忽略,且错误提示不明确。


















