Skip to content

在 VPS 上使用 Docker 一键部署 Sing-box 服务端

易邦

在海外 VPS 上手搓搭建代理节点时,相较于一键安装脚本带来的依赖冲突与系统污染,使用 Docker 容器化部署是目前极客圈最推崇的方案。

今天我们将通过 Docker Compose 部署一套生产级、包含 VLESS-Reality 的高性能 Sing-box 服务端!

[!NOTE] 📌 核心速览(TL;DR / 快问快答):

  • 网络栈优化:必须配置 network_mode: "host",消除 Docker 内部 NAT 端口映射开销,榨干 VPS 网卡带宽。
  • 权限配置:声明 cap_add: [NET_ADMIN],以便容器支持 TProxy 与高级路由。
  • 零残留升级:配置文件映射宿主机 ./config.json,升级仅需 docker compose pull && docker compose up -d。

🛠️ 1. 编写生产级 docker-compose.yml

在 /opt/singbox 目录下创建配置文件:

version: "3.8"

services:
  sing-box:
    image: ghcr.io/sagernet/sing-box:latest
    container_name: sing-box
    restart: always
    network_mode: "host"
    volumes:
      - ./config.json:/etc/sing-box/config.json
    cap_add:
      - NET_ADMIN

⚙️ 2. 服务端 config.json 核心模板

{
  "log": {
    "level": "info",
    "timestamp": true
  },
  "inbounds": [
    {
      "type": "vless",
      "tag": "vless-reality-in",
      "listen": "::",
      "listen_port": 443,
      "users": [
        {
          "uuid": "your-client-uuid",
          "flow": "xtls-rprx-vision"
        }
      ],
      "tls": {
        "enabled": true,
        "server_name": "node.yourdomain.com",
        "reality": {
          "enabled": true,
          "handshake": {
            "server": "www.microsoft.com",
            "server_port": 443
          },
          "private_key": "your-singbox-reality-private-key",
          "short_id": ["0123456789abcdef"]
        }
      }
    }
  ],
  "outbounds": [
    {
      "type": "direct",
      "tag": "direct"
    }
  ]
}

执行 docker compose up -d 即可秒级启动!


🐳 为什么生产环境推荐 Docker 而不是一键脚本?

一键脚本把二进制、systemd 服务、依赖库全装进宿主机系统,卸载残留、升级翻车、换 VPS 迁移都是体力活。Docker 方案的优势:


🏷️ 镜像版本策略:别无脑追 latest

ghcr.io/sagernet/sing-box:latest 方便,但生产节点建议 pin 住具体版本(如 :1.12.0),原因:

  1. Sing-box 大版本偶有破坏性配置变更,latest 半夜自动更新可能导致节点失联。
  2. 升级应该是你主动做的:先看 GitHub Release 的 changelog,确认配置兼容再 docker compose pull。

推荐流程:测试环境先用 latest 验证 → 生产 compose 文件写死版本号 → 每月手动升级一次。


💾 数据持久化与备份

Compose 文件里只映射了 config.json,建议再加两样:

volumes:
  - ./config.json:/etc/sing-box/config.json
  - ./data:/var/lib/sing-box   # 缓存与状态
  - ./logs:/var/log/sing-box   # 日志落盘方便排查

备份就是 tar -czf singbox-backup.tar.gz /opt/singbox,换机器解压即用。


🔧 日常运维三板斧

docker compose logs -f --tail=100   # 实时看日志
docker compose pull && docker compose up -d  # 升级
docker compose exec sing-box sing-box check -c /etc/sing-box/config.json  # 升级前校验配置

check 这一步很关键:Sing-box 启动时配置写错会直接退出,升级前先校验能避免”手一抖节点全灭”。


🧩 同一 VPS 跑多协议节点

想在一个 VPS 上同时跑 VLESS-Reality(443)+ Hysteria2(UDP 8443)?再起一个 service 即可,共用 host 网络:

services:
  sing-box-reality:
    image: ghcr.io/sagernet/sing-box:1.12.0
    network_mode: "host"
    volumes: ["./reality.json:/etc/sing-box/config.json"]
  sing-box-hy2:
    image: ghcr.io/sagernet/sing-box:1.12.0
    network_mode: "host"
    volumes: ["./hy2.json:/etc/sing-box/config.json"]

注意两个配置文件的 listen_port 不能冲突。


❓ 常见问题与 AI 快问快答 (FAQ)

Q1: 如何在 Docker 容器内生成 Reality 密钥对?

答:无需本地安装任何工具,直接使用 Docker 镜像生成:

docker run --rm ghcr.io/sagernet/sing-box:latest generate reality-keypair

Q2: 选购哪家 VPS 主机部署 Sing-box 容器体验最佳?

答:推荐选择 DMIT 或 搬瓦工 的 中国电信 CN2 GIA 或 联通 AS9929 专线小鸡,单核 1G 配置即可轻松跑满千兆带宽。

Q3: 升级镜像后容器起不来了,怎么排查?

答:三步走:① docker compose logs --tail=50 看报错,90% 是配置文件字段被新版废弃;② 对照 Release changelog 修改配置;③ 用 sing-box check 校验通过后再 up -d。实在修不好就把 image tag 改回旧版本号回滚。

Q4: host 网络模式下端口被占用怎么办?

答:host 模式没有端口映射隔离,宿主机上跑了 Nginx 占 443 就会冲突。用 ss -tlnp 查占用者,要么停掉它,要么把 Sing-box 的 listen_port 换成别的(如 8443)。


(总纲阅读:《VPS 从零部署 Sing-box 节点服务端实战》,从选购到上线全流程。) (相关资源导航:如果您需要购买适合部署 Docker 节点的海外 VPS,欢迎阅读 《2026 国外 VPS 选购指南》 获取 DMIT、搬瓦工与 CloudCone 优惠;商用专线机场评测见 《“饿饭CC云”深度评测》!)

上一篇
Sing-box 自定义规则集 (.srs) 编译与使用进阶教程
下一篇
为什么大家都开始用 Sing-box?与 Clash、V2Ray 核心原理对比