SELF_HOSTED · CN CLOUD REGISTRY

你的服务器，你的网络

一台 Linux 服务器 + 一个部署脚本，5 分钟拥有完全属于你的小圈子。镜像自动从国内云仓库拉取，脚本零依赖——国内服务器友好。

云仓库直连 · 国内极速拉取

数据端到端加密 · 中转零知识

中转集群 · 按需扩容

查看部署指南

单文件部署脚本 · 镜像自动从国内云仓库拉取 · 兼容 Debian / Ubuntu / CentOS

DEPLOY_GUIDE

三步完成部署

全程脚本自动完成：装 Docker → 加载离线镜像 → 建库 → 启动 → 健康检查

1

上传部署脚本到服务器

下载 deploy.sh，上传到服务器（任意有公网 IP 的 Linux 机器，推荐 2 核 2G）：

$ scp xiaoquanzi-deploy.sh root@你的服务器IP:/opt/xiaoquanzi/

2

运行一键脚本

脚本自动安装 Docker（阿里云源）、从国内云仓库拉取镜像、创建数据库、启动服务并做健康检查：

# 一体化控制面（含数据库 + 内置中转节点）

$ sudo bash /opt/xiaoquanzi/xiaoquanzi-deploy.sh --control --tls-domain api.example.com

# 或：独立中转节点（扩容用，接入已有 HTTPS 控制面）

$ sudo bash /opt/xiaoquanzi/xiaoquanzi-deploy.sh --relay --control-endpoint api.example.com:9000 --reg-key 注册密钥

3

登录管理台，生成邀请码接入

部署完成后终端与部署目录输出管理员账号、初始注册密钥（凭据文件 chmod 600 保护）。打开 https://api.xiaoquanzi.cc:9000/admin.html 登录管理台 → 生成邀请码（形如 xqz-…，次数/有效期可配）→ 成员在客户端「加入网络」粘贴邀请码即完成接入，全程无需输入 IP。

凭据备份部署目录 credentials.txt（管理员账号 / 数据库密码）

TOPOLOGY

一个部署包，形态自动演化

部署即自带中转；接入更多中继节点后自动集群化，无需重新部署

个人 / 小团队私有云

控制面包单机部署（控制面 + 数据库 + 内置 DERP 中转 + Web 管理台）。一台 2 核 2G 服务器（约 30 元/月）即可支撑 10 人圈子，开箱即用。

适用规模10 人以内

最低配置2 核 2G · 公网 IP

开放端口9000/tcp + 52320/tcp

跨地域团队（按需加中继）

在不同运营商/地域的机器上追加纯中转节点包（零依赖，1 核 512M 起步）—— 注册即自动接入，成员就近选择中转（延迟/负载自动排序），中继故障秒级切换。

适用规模跨地域团队 / 带宽扩容

中转节点1 核 512M 起步 · 水平扩展

开放端口52320/tcp（TCP/WebSocket 同端口）

任何规模：数据全程 WireGuard 端到端加密，中继节点零密钥零知识，服务器看不到任何业务内容。

FAQ

常见问题

镜像从哪里拉取？国内服务器快吗？

业务镜像发布在国内云镜像仓库（腾讯云），服务器直连拉取秒级完成，无需任何特殊网络配置；数据库基础镜像经 Docker Hub 国内加速器拉取。唯一可能联网的环节是服务器尚未安装 Docker 时的自动安装（阿里云源），已装 Docker 的机器全程顺畅。

后续如何升级版本？

新版本发布后，服务器上执行 sudo FORCE_PULL=1 IMAGE_TAG=新版本 bash xiaoquanzi-deploy.sh --control 即可——脚本自动复用既有数据库密码（数据不丢）、强制拉取新镜像并重建容器。中转节点同理。

服务器需要开放哪些端口？

控制面：9000/tcp（Web 管理台与 API）+ 52320/tcp（内置 DERP 中转，TCP/WebSocket 同端口，封 UDP 的网络环境也能用）。中转节点：仅 52320/tcp。在云厂商安全组与系统防火墙（如有）中同时放行——安全组默认拒绝入站是部署失败最常见的原因。

自建后官方客户端还能用吗？

能。客户端节点选择页支持官方节点与多个自建节点并存，随时切换——切换后账号在对应控制面独立记账，各自的圈子互不影响。