Linux Server

Linux Server 适合把 North Coder 放在远程机器上长期运行，再通过浏览器访问完整客户端。

前置条件

• 已安装 Linux 版 ncoder。
• 服务器上能访问目标代码仓库。
• 已确认防火墙、反向代理或内网入口策略。

启动服务

export PATH="$HOME/.local/bin:$PATH"
ncoder server start --host 0.0.0.0 --port 8848

命令会输出带 token 的访问地址。打开服务器 IP 对应的那条：

http://<server-host>:8848?token=<generated-token>

如果服务只给本机反向代理访问，可以把 host 设为 127.0.0.1。如果需要从其他机器直接访问，才使用 0.0.0.0。

常用参数

安全基线

• 远程访问必须使用启动输出里的 token URL。
• 暴露到 localhost 之外时，应放在 TLS 入口后面。
• 优先使用私有网络、VPN 或带认证的反向代理。
• 不要把访问 URL 粘贴到公开群组、issue 或日志系统中。

浏览器访问

浏览器打开服务地址时需要携带启动输出中的 token 查询参数。

建议把服务入口固定在受控域名后，例如公司内网域名或 VPN 域名。这样后续更换服务器、端口或 TLS 证书时，用户不需要记忆新的裸 IP 地址。

前端静态资源

打包后的 server 默认会服务内置前端。只有在其他服务负责托管 Web 资源时，才直接运行 serve --no-serve-frontend。

停止与重启

使用 daemon 模式时：

ncoder server stop
ncoder server start --host 0.0.0.0 --port 8848

如果需要交给 systemd 或容器编排管理，也可以直接运行底层 serve 命令，并显式提供受控环境变量中的 token。

重启后确认：

1. 服务端口已经监听。
2. 浏览器可以打开首页。
3. token 验证正常。
4. 目标代码仓库仍然可读写。