安装与部署

系统要求#

编译与获取#

Celium 是纯 Go 程序，没有 cgo 依赖。你可以直接编译：

git clone <仓库地址> && cd celium
make build          # 产出 bin/celium、bin/celiumd、bin/celium-control

三个二进制各自的分工：

Linux：APT 安装#

Debian/Ubuntu 的 amd64、arm64 可使用官方签名软件源。首次使用先添加与系统版本对应的软件源，再安装：

set -o pipefail
. /etc/os-release
sudo mkdir -p -m 0755 /usr/share/keyrings
curl -fsSL "https://img.uulucky.com/celium/stable/$ID/$VERSION_CODENAME.noarmor.gpg" | sudo tee /usr/share/keyrings/celium-archive-keyring.gpg >/dev/null
curl -fsSL "https://img.uulucky.com/celium/stable/$ID/$VERSION_CODENAME.celium-keyring.list" | sudo tee /etc/apt/sources.list.d/celium.list
sudo apt-get update
sudo apt-get install celium
celium up

例如 Ubuntu 16.04 使用 stable/ubuntu/xenial.noarmor.gpg 和 stable/ubuntu/xenial.celium-keyring.list。当前提供 Ubuntu xenial、bionic、focal、jammy、noble、questing、resolute，以及 Debian bullseye、bookworm、trixie。其他发行版或派生版请先确认它对应的 Ubuntu/Debian 版本，再使用对应目录和代号。

当前软件源公钥指纹为 CD5D B4FE 435D EA1C 6657 87CE 527C 7DFE 0EBB 0603。你可以用 gpg --show-keys --fingerprint /usr/share/keyrings/celium-archive-keyring.gpg 核对。软件包从 CDN 下载，APT 仍会校验签名和包哈希。已有的 https://pkgs.celium.cn/ 软件源会转向 CDN，继续可用；重新执行上述命令会把 /etc/apt/sources.list.d/celium.list 直接切换到 CDN 的版本目录。

安装包包含 celium、celiumd 和 celiumd.service，安装后自动启用并启动守护进程。通过普通用户的 sudo 安装时，该用户可以直接使用 celium up；如果由 root 或自动化系统安装，则用 sudo celium up。signed-by 只把软件源公钥用于 Celium 软件源，不会变成系统所有软件源的通用信任密钥。

在使用 systemd-resolved 的 Linux 上，Celium 将 mesh.celium.cn 配成自身网卡的搜索域，因此可用 ping win11-u5 这样的短设备名。APT 包建议同时安装 libnss-resolve，让系统命令读取当前的分网卡搜索域；若安装时禁用了推荐包，可运行 sudo apt-get install libnss-resolve。完整设备名 win11-u5.mesh.celium.cn 也可直接使用。普通上网模式下，Celium 不接管其他网络的默认 DNS；选择出口后，公共 DNS 经出口查询。

已有其他 VPN 的 Linux 主机可以同时安装 Celium。Celium 使用 celium0、10.239.0.0/16 和 10.239.255.254。使用 systemd-resolved 时，Celium 只为自己的域名设置分流 DNS；如果另一 VPN 已在运行而主机直接管理 /etc/resolv.conf，Celium 不会覆盖它，需另行配置 Celium 域名解析。若已有局域网、其他 VPN 或子网路由使用 10.239.0.0/16，仍会出现路由重叠；两个出口节点也不能同时作为系统默认出口。

当前 Linux 客户端为 0.1.61（amd64 / arm64）。需要手动升级时运行：

celium update

它通过 sudo 运行 apt-get update，然后只升级 celium 包；升级会短暂重启守护进程。也可直接运行 sudo apt-get install --only-upgrade celium。

0.1.46 修复了 Linux 节点路由的源地址选择：访问其他 Celium 设备时始终使用本机节点地址，避免把 MagicDNS 的 10.239.255.254 误作源地址；节点地址变化时会同步更新已有路由。MagicDNS 地址仍保留，升级无需重新登录或注册设备。

也可下载对应架构的安装包，核对 SHA-256 后运行 sudo apt install ./celium_0.1.61_你的架构.deb：

手动部署二进制时，仍可执行 sudo install -m 0755 celiumd celium /usr/local/bin/，随后用 sudo celiumd 启动。注意 /usr/local/bin 通常排在 /usr/bin 前面；若从手动部署迁移到 APT，请先移走旧二进制，避免继续运行旧版本。

macOS：DMG 安装#

选择与你的 Mac 芯片对应的安装镜像，当前版本为 0.1.61。在“苹果菜单 → 关于本机”可以查看芯片或处理器：显示 Apple 芯片选 Apple Silicon，显示 Intel 处理器选 Intel。

下载后，可在终端运行 shasum -a 256 ~/Downloads/Celium-0.1.61-macOS-Apple-Silicon.dmg（Intel 机型换成 Intel 文件名），将输出与上表比对。然后打开 DMG，双击里面的“Install Celium.pkg”，按提示输入 Mac 管理员密码。安装会添加“应用程序”中的 Celium Desktop、/usr/local/bin/celium 和 celiumd，并设置开机自动启动的 cn.celium.celiumd 服务。

这些安装包没有 Apple Developer ID 签名和公证。首次打开若被 macOS 拦截，先尝试打开安装包一次，再打开“系统设置 → 隐私与安全性”，在安全性提示中点“仍要打开”，确认后继续安装。只对从本页下载、且校验值吻合的安装包执行此操作；无需关闭系统的整体安全检查。详细操作见 Apple 的打开说明。

安装完成后，从“应用程序”打开 Celium Desktop，点击“连接”。安装程序会将当前 Mac 登录用户设为 Celium 本机操作员，之后查看状态、连接、断开和修改端口无需反复输入 macOS 管理员密码。首次连接时，界面会显示“打开授权页面”；登录并批准设备即可。窗口自动刷新连接状态和设备列表，侧栏提供文件、诊断、设置和账号。关闭窗口后再次点击 Dock 中的 Celium 图标会恢复同一个窗口。0.1.53 起，开启自动安装更新后，由已安装的系统服务下载、校验并安装官方更新；也可手动下载 DMG 升级。升级时安装程序会先等待旧服务退出，再启动并检查新版服务，随后重启正在运行的 Celium Desktop，让新版本立即生效。连接和刷新均有超时保护，失败后可重试；具体原因显示在诊断详情。

连接后，macOS 会把 mesh.celium.cn 加入搜索域，可在终端使用 ping win11-u5 或 ping win11-u5.mesh.celium.cn。Celium 只为自身域名配置分流 DNS，不替换其他网络的默认 DNS。

也可以在“终端”执行：

celium up
celium status
celium up --port=41641

第一次 up 会显示设备授权链接；在浏览器登录 Celium 并批准这台 Mac 后，命令会继续。安装时指定的本机用户可以直接运行 celium 命令；其他 Mac 用户仍需管理员授权。root 守护进程管理系统分配的 utun 接口和节点私钥；控制 socket 仅允许 root 和安装时指定的用户访问。更换本机操作员时，用新用户登录 Mac 并重新运行安装包。以后重启 Mac，守护进程会自动启动。

macOS 可运行 celium update --install，通过已安装的系统服务检查并安装官方更新；也可在 Celium Desktop 中更新。现有设备身份与配置会保留。使用 DMG 安装后无需手动启动或结束 celiumd。

不使用 DMG 时，也可手动安装二进制并启动守护进程：

sudo install -m 0755 celiumd celium /usr/local/bin/
sudo celiumd

用户态模式不创建 utun，也不需要 root：

celiumd --tun=userspace --userspace-proxy=127.0.0.1:1080

如果旧版升级失败、卡在“正在连接”或提示服务未响应，从本页重新下载最新版 DMG 并运行安装包即可。安装会保留设备身份与配置，无需删除应用数据或手动查找进程。

Windows：桌面客户端#

当前官网下载版为 0.1.65，提供 Windows 10/11 的 AMD64 和 Windows 11 ARM64 安装包。根据“设置 → 系统 → 系统信息”中的系统类型选择文件；Intel/AMD 处理器选 AMD64，ARM 处理器选 ARM64。

用 PowerShell 核对下载文件：

Get-FileHash .\Celium-0.1.65-Windows-amd64.zip -Algorithm SHA256

把 ZIP 完整解压到一个目录，再双击 CeliumSetup.exe，按提示授予管理员权限。安装后从开始菜单打开 Celium Desktop，点击“连接”；首次连接会显示设备授权地址。也可以直接运行 C:\Program Files\Celium\CeliumDesktop.exe。celium.exe 是命令行工具，直接双击会一闪而过。客户端窗口每 5 秒自动刷新连接和设备状态，并保留当前滚动位置与选中设备，也可手动点击“刷新状态”；点击“断开”后会确认实际状态再显示结果。主窗口可拖动边缘放大，也可最大化；文件列表与传输进度随窗口扩展，便于查看更多文件。0.1.65 修复更新过程中的中文提示乱码与文件页命令参数重复转义。窗口还提供诊断详情、手动“检查更新”和“立即更新”。最小化后可从任务栏恢复，或双击通知区域里的 Celium 图标。更新时窗口会显示“正在更新”和当前阶段，安装过程中服务短暂重启；完成或失败都会在窗口中显示结果。如果更新完成后界面仍是旧样式，请关闭旧窗口，从开始菜单重新打开 Celium Desktop；新版客户端以后的更新会自动重开窗口。即使更新时关闭窗口，重新打开也会读取最近的更新进度。

安装器会添加一条入站 ICMPv4 规则，让 10.239.0.0/16 内的节点 ping 这台 Windows 设备；另为 celiumd.exe 添加文件接收 TCP 41644 规则，仅允许同一 Celium 网段的来源与目的地址；接收端仍检查同一账号的设备身份。Celium 当前没有 Authenticode 证书，Windows 可能显示“未知发布者”或 SmartScreen 提示。请从本页下载、核对 SHA-256，再按 Windows 提示继续；无需关闭系统安全功能。安装包中使用上游已签名的 Wintun 驱动，但这不代表 Celium 程序本身已签名。Celium 使用独立的虚拟网卡和地址段，可与已有 VPN 安装共存。

Windows 0.1.46 为 Celium 网卡配置 mesh.celium.cn 搜索后缀，并只把该域名的查询交给本机 MagicDNS。连接后可在 PowerShell 运行 Resolve-DnsName win11-u5 或 Resolve-DnsName win11-u5.mesh.celium.cn 检查。

0.1.46：图形化文件与文字传输#

Mac 与 Windows 官网安装版增加“文件”页，与 iOS、Android、HarmonyOS 的文件协议兼容。连接后选择同一账号的在线设备，点击“发送文件”或“文字或链接”。对方需保持 Celium 连接；文件不上传到协调服务器保存。

支持一次选择多个文件、实时进度和取消；收到对方确认后才显示发送完成。发送失败会提示未完成项，已完成的文件仍保留。每次最多 100 个文件，单个文件最多 8 GiB；文件夹请先压缩。文字或链接最多 64 KiB。

收到的文件会自动出现在接收列表。可单独保存或全部保存到所选文件夹、查看与复制文字全文；默认建议保存到“下载”文件夹。同名文件自动编号，避免覆盖。保存后接收箱原件保留，收到的文件不会自动打开或执行。

新版保留原设备身份与连接设置，无需重新注册设备。Mac 安装完成后会自动重开此前运行的客户端；Windows 在更新窗口显示进度并自动重开。此页 Windows ZIP 为官网安装版；Microsoft Store 版本按商店自己的审核与更新进度分发。

0.1.55 优化设备列表的搜索与筛选布局、系统标识、选中样式和在线状态标签，账号显示统一为“账号:用户名”。

修复文件页因后台进程退出码与空错误文本导致的设备下拉列表为空；文件列表与发送结果以完整返回数据确认。

权限：两种数据面#

用户态模式是容器、CI、以及没有 root 的环境里的实用选择：协议栈在进程内运行，程序通过--userspace-proxy 给出的本地代理访问内网。

celiumd --tun=userspace --userspace-proxy=127.0.0.1:1080
curl --socks5-hostname 127.0.0.1:1080 http://db-1:5432

协调服务器#

celium-control \
  --domain=mesh.vpn.example.com \
  --listen=:8080 \
  --tls-cert=/etc/letsencrypt/live/vpn.example.com/fullchain.pem \
  --tls-key=/etc/letsencrypt/live/vpn.example.com/privkey.pem \
  --derp --derp-hostname=derp.example.com

账号创建要求用户名至少 6 位、密码至少 8 个字符。所有密码登录入口共用失败计数：同一用户名在 1 分钟内失败 5 次锁定 1 分钟、10 分钟内失败 10 次锁定 10 分钟、24 小时内失败 20 次锁定 24 小时；同一客户端 IP 在 24 小时内失败 100 次锁定 24 小时。触发后返回 HTTP 429 和 Retry-After。计数保存在状态目录，重启不会清零。部署在本机 Nginx 后面时，请使用 --trust-loopback-proxy；协调服务必须只监听回环地址，Nginx 应覆盖 X-Real-IP 为真实来源 IP。

同一 IP 在滚动 1 分钟内最多成功注册 5 个账号、滚动 24 小时内最多成功注册 10 个账号。管理员可在 /admin 的 Security alerts 查看并确认告警，在 Active locks 解除用户名、登录 IP 或注册 IP 的限制；这些操作也会写入服务器日志。使用管理员令牌可在用户名锁定期间登录管理页进行恢复。

关于控制公钥：它保存在状态目录的 control.key 里，服务器每次启动都会打印。它的公开部分被所有节点 pin 住，所以不要在已有部署上重新生成——那等于让每个节点都拒绝这台服务器。

备份#

协调服务器的状态目录（默认 /var/lib/celium-control，或你指定的 --statedir）就是整个部署的身份：账号、节点、地址分配、策略、控制密钥。备份它一个目录即可。

节点的状态目录（默认 root 下 /var/lib/celium，普通用户下 ~/.celium）保存机器密钥、节点密钥、偏好与会话。机器密钥决定设备身份，丢了会被服务器当成一台新设备；节点密钥也保存在此目录。不要为了更新客户端删除状态目录，否则可能失去现有设备身份或授权。

移动端#

Android#

支持 Android 8.0 及以上的 ARM64 和 x86-64 设备。当前版本为 0.1.69：

下载后可用 sha256sum Celium-0.1.69-Android.apk 核对。打开 APK，按 Android 提示允许此次安装，然后打开 Celium，登录账号并点击“连接”；首次连接需批准系统 VPN 请求。界面与 iOS 统一为“网络、服务、文件、我的”四个入口；无需邀请码即可注册，邮箱可留空或稍后验证。支持设备状态自动刷新、设备搜索、诊断和文件收发。客户端会自动检查新版本；账号、连接设置、后台保护、更新和使用帮助统一在“我的”中，发现新版时“我的”底部入口显示提示点。“检查更新”采用普通列表项，发现新版时右侧显示“发现新版本”；只有点击后才打开底部更新面板，在其中下载，等待校验完成后在 Android 系统安装界面确认。首次使用应用内更新时，Android 可能要求允许 Celium 安装来自此来源的应用。APK 使用 Celium 的固定签名证书，可直接覆盖安装旧版本。

0.1.69：更新入口与未读角标修复。 “检查更新”统一为列表入口，自动检测仅提示新版本，不主动弹出更新窗口。文件角标只统计未读，进入“已接收”后清除，重开应用保持已读，新收到或同名重新接收的文件会再次提醒；接收原件保留。网络页采用紧凑连接卡和单一连接操作，本机地址可直接复制，详情与诊断在底部面板查看；服务支持搜索、收藏、最近使用、复制地址及端口测试。文件页展示进度、直连／中继、实时速度和预计剩余时间，传输设置支持预设与自定义 MiB/s 限速，修改后自动保存并读回确认，失败可重试；点按收到的文字、图片或普通文件，可预览、复制、另存、分享，图片／视频支持保存到相册，删除本机文件前再次确认。“我的”统一管理账号、已验证邮箱、套餐额度、连接设置、后台保护和更新；更换邮箱保留新旧邮箱双重验证。

0.1.61：统一邮箱安全弹窗。 “我的”只保留邮箱状态和“管理邮箱”入口。更换时先验证旧邮箱，再验证新邮箱；两步必须在旧邮箱验证后的 10 分钟内完成。首次绑定只需验证新邮箱，已验证的当前邮箱不重复发码。返回修改、取消和关闭会清除验证码并撤销本次更换授权。

Android 默认只把 Celium 网段 10.239.0.0/16 送入 VPN。Android 10 及以上在连接前会测试物理网络 DNS；普通上网模式中，MagicDNS 在本机回答设备名，公共域名通过手机当前非 VPN 的 Wi-Fi 或蜂窝网络查询。若预检失败或 Android 8–9，保留系统 DNS，诊断会显示 AndroidMagicDNS: system DNS fallback。选择出口后会重建 VPN 默认路由，并强制通过虚拟 DNS 将公共查询送往出口；切回普通上网时恢复设备网段路由。

0.1.46：断线自动重连。 网络切换、休眠唤醒或数据通道短暂中断后，Celium 不再直接退出，而是保留通知栏并自动重连（间隔依次为 2、5、10、30、60 秒，之后每 60 秒一次；网络恢复时立即重试），状态显示“正在重连”。只有点击“断开”、账号授权失效或 VPN 授权被撤销时才会停止。手机重启或应用更新后，如果断开前处于连接状态，会自动恢复连接。

为了长期在线，建议在手机上：打开系统 VPN 设置中 Celium 的“始终开启的 VPN”（不要勾选“阻止未使用 VPN 的连接”）；允许 Celium 自启动和后台高耗电（vivo、OPPO、小米等在“电池/后台耗电管理”和“自启动”中设置）；在最近任务中锁定 Celium；不要同时开启加速器或其他 VPN，Android 同一时间只允许一个 VPN。

本版保留原有签名与设备身份，可直接覆盖升级，无需卸载或重新注册。

0.1.57：账号会话恢复。 网络页和“我的”固定显示当前账号。服务页发现登录失效时显示“重新登录”，使用原账号补充密码及两步验证码后自动重载目录，保留现有设备身份和 VPN 连接。取消或密码错误不会退出当前连接；切换其他账号仍需先退出登录。

iOS#

通过现有 TestFlight 邀请安装 Celium。0.1.70（build 24）已加入原 TestFlight 内部测试组，当前正在测试。新版统一“网络、服务、文件、我的”四个页面，支持设备与服务搜索、收藏、连接诊断和文件传输进度；可查看直连/中继、速度与预计剩余时间。文件角标记录未读，查看后清除；传输设置支持仅 Wi-Fi 和自定义限速。检查更新采用列表入口，点击后显示更新详情，安装仍通过 TestFlight 完成。两步邮箱安全弹窗与“收起键盘”操作继续保留。

HarmonyOS#

HarmonyOS 5 及以上使用 Celium 原生客户端，通过现有 AppTest 邀请更新。0.1.71（17101）已提交原邀请测试组，当前为预审中，审核通过后才能更新。新版统一网络、服务、文件、我的四页，增加服务搜索与收藏、文件操作弹层和持久化未读提醒；独立传输设置支持仅 Wi-Fi、自定义限速及保存回读。已在 MRT-AL10 真机验证界面、设置保存、连接/断开和与 Linux 双向文件收发，保留原账号与设备身份。实际可安装版本以 AppTest 页面为准。

0.1.24：设备搜索与分层诊断#

Windows、macOS 和 Android 可按设备名称、IP、完整域名或系统搜索，筛选在线设备和收藏。收藏按稳定设备身份保存，设备改名后仍保留。Mac 打开设备菜单，Windows 右键设备，Android 点击设备卡片，可复制 IP、复制 MagicDNS 完整域名、收藏或测试连接。Windows/macOS 启动后及每小时会在后台检查新版，手动检查仍可用；Android 更新继续位于右上角菜单。

“在线”表示设备连接了协调服务，不保证远程桌面、SSH 或网页服务可用。连接测试分别显示隧道结果和 TCP 端口结果；隧道成功而端口失败时，请检查目标服务、访问策略和防火墙。Mac/Windows 提供常用的 22、443、3389 端口；Android 可输入所需端口。端口测试只验证 TCP 建连，不验证应用登录。未发生通信的连接路径显示“待测试”。本机断开后列表显示“本机未连接”，避免把缓存当成当前在线。

Linux 和桌面命令行可使用：

celium status --filter=win --online
celium status --watch=5s
celium diagnose
celium diagnose win11-u5 --port=3389
celium diagnose rk3318-box-5 --port=22 --json

diagnose 检查系统 DNS、连接状态，并按需测试选中的设备与 TCP 端口。代理模式下端口测试使用系统路由，应用仍需配置 Celium 代理。新的界面诊断与 celium status --view 使用精简字段，不包含密钥、签名或会话令牌；仍含设备名、域名和私网 IP，请在分享前查看内容。原有 celium status --json 完整格式继续保留。

Android 若启用了系统的“阻止未使用 VPN 的连接”，普通流量可能被系统阻断。Celium 当前使用设备网段分流，需要普通 App 继续上网时，请在系统 VPN 设置中关闭该选项。DNS 预检降级会在状态说明中提示。

0.1.24：出口设置与普通上网#

四个平台均支持提供出口和选择管理员已批准的出口。默认是“普通上网”，只连接设备网络；批准某个出口不会自动改变其他设备的上网方式。

1. 提供出口：先连接 Celium，再在有稳定互联网连接的设备开启“提供本机作为出口”。Mac/Windows 打开主窗口的“出口设置”；Android 点击右上角“⋮ → 出口设置”。Linux 运行 celium up --advertise-exit-node。
2. 管理员批准：打开 设备管理，进入对应设备的“详情 → 批准出口节点”。设备必须已经申请出口、获得设备授权且密钥未过期。申请阶段显示“等待管理员批准”。
3. 选择出口：在需要经该设备上网的客户端打开“出口设置”，选择在线的已批准设备。Linux 运行 celium exit-node 查看列表，再运行 celium exit-node 设备名；也可使用出口 IP 或稳定设备 ID。
4. 切回普通上网：在同一设置中选择“普通上网”；Linux 运行 celium exit-node none。设备网络继续连接，默认路由和公共 DNS 恢复原网络。
5. 停止提供或撤销批准：出口设备关闭“提供本机作为出口”（Linux：celium exit-node --advertise=false）；管理员也可在设备详情中“撤销出口批准”。重新提供后需重新批准。

出口离线、删除或被撤销批准时，客户端显示“出口不可用”，上网流量保持阻断，不自动改走本地网络；可手动切回普通上网。不能同时提供出口并使用另一出口。出口设备须保持在线，电脑睡眠或手机后台限制会影响可用性。

本版出口使用进程内 TCP/UDP 转发，不需要手工启用内核 IP 转发或配置 NAT。当前验证范围为 IPv4 TCP/UDP；IPv6 上网会阻断以避免绕过出口，暂不承诺任意 IP 协议或出口 ICMP。公共 DNS 默认通过出口访问 223.5.5.5，失败时尝试 1.1.1.1。协调服务与隧道握手仍使用原网络，避免出口故障阻断控制连接。

自定义访问策略必须允许客户端访问需要的公网地址和端口；只允许设备网段的策略会阻止出口上网。不要同时让两个 VPN 接管系统默认出口。Windows 实机由用户自行验收；发布测试覆盖 Go 转发、隔离 Linux 路由、Mac 样例界面和 Android 模拟器 JNI，不替代每台设备的网络测试。

0.1.46：修复状态栏、刘海及底部导航遮挡；服务目录请求使用 Android 底层网络 DNS 和受保护连接，并提供刷新、失败重试及正常的空目录提示。

文件传输中心（0.1.61）#

Windows、macOS、Android、iOS、HarmonyOS 的文件页提供“传输中、已接收、历史”，Linux 使用 celium file tasks --watch 查看同一任务信息。选择自己账号下的设备发送文件、文字或链接；离线设备会等待上线。

• 进度以接收方确认写入的字节为准；传完后仍需完整性校验，只有对方保存成功且 SHA-256 一致才显示 100%。
• 传输时显示速度、剩余时间及当前直连／中继路径；完成后查看平均速度和传输详情。路径暂时无法确认时会如实提示。
• 新版双方支持分块续传，可暂停、继续、重试或取消；重启后保留队列。发送方会保留私有待发副本，取消或到期后清理。每台设备同时发送最多两个任务。旧版接收方会明确提示不支持断点续传和校验回执。
• 可设置发送限速；移动端支持仅 Wi-Fi 发送。手机仍受系统后台运行限制，传输时建议保持 Celium 可运行。
• 同名文件自动另存，保存失败保留原接收文件；“清除记录”不等于删除收到的文件。手机图片、视频可保存至相册，系统可能要求照片权限或确认。
• Android、iOS、HarmonyOS 可从系统分享菜单暂存文件，回到 Celium 选择接收设备后才发送。文件直接在设备间传输，不上传到协调服务器保存。

Linux 可用 celium file pause 任务编号、celium file resume 任务编号、celium file retry 任务编号、celium file cancel 任务编号；celium file policy --limit-kib 1024 设置每任务限速，--limit-kib 0 恢复不限速。Ctrl+C 仅停止进度查看，后台任务仍可继续。

邮箱绑定、验证与更换#

网页进入“账号安全”，客户端进入“我的／我的账号 → 管理邮箱”。网页、Windows、macOS 使用紧凑弹窗，Android、iOS、鸿蒙使用原生弹层。Linux 运行 celium email --open 打开同一安全页面；无桌面时运行 celium email 查看入口。

修改邮箱分两步：先填写新地址并验证旧邮箱，再向新邮箱发送验证码并确认更换。旧邮箱通过验证后，须在 10 分钟内完成；过期或返回修改需重新验证。验证成功前原邮箱保持绑定；取消不修改邮箱。首次绑定只需验证新邮箱。桌面端必要时会在弹窗内再次验证账号，不会断开设备网络。

同一邮箱发送间隔 60 秒，每 24 小时最多 5 封；同一 IP 每 24 小时最多 10 封。旧、新邮箱分别计算间隔。验证码和临时授权不写入客户端偏好设置。旧邮箱无法收信时请联系支持。

忘记密码#

官网登录页与各客户端提供“忘记密码”入口。通过找回密码页面填写用户名和此前已验证的邮箱，输入邮件中的 8 位验证码及新密码即可重置。未验证邮箱不能用于自助重置。验证码 10 分钟有效，最多尝试 5 次；重置后旧账号登录会话退出，两步验证和设备身份保留。Linux 可运行 celium reset-password 查看入口。

0.1.52：注册保护与套餐额度#

按北京时间自然日统计全站成功注册数：前 100 个账号无需图形验证码，从第 101 个起需要输入图形验证码。验证码有效 3 分钟，仅可使用一次，并绑定本次用户名和来源 IP。切换设备、刷新验证码或输错后请使用新验证码。原有同 IP 每分钟 5 个、滚动 24 小时 10 个成功注册限制继续生效；验证码不替代这些限制。注册来源与来源 IP 仅在有权限的系统管理后台查看。

设备名额按保存的设备总数计数：离线、待批准和密钥过期的设备仍占名额；点击“断开”不会释放，删除不用的设备后才释放。标准版 18 台是整个网络共用，不是每用户 18 台。新增设备、用户和策略由服务器统一检查，不能通过旧客户端绕过。套餐到期后新增操作按个人版检查，已有记录不会自动删除。当前中继流量额度用于用量提示，尚未启用超额自动断流。

达到限制时，先在 设备管理 删除不用的设备，或打开 套餐与升级 查看用量、购买席位及升级。标准版每用户每月 ¥29，高级版每用户每月 ¥65；已有付费账期中的席位调整于下一账期生效并收费，请以付款页面的生效时间为准。历史兼容网络保留已有权益，不套用普通新注册个人版额度。

桌面客户端可打开“套餐额度与升级”；Android 在“我的”查看用量，iOS 在设置中查看。命令行登录账号后可运行：

celium plan
celium plan --json

未登录账号时先运行 celium login；设备的浏览器授权和账号会话登录是不同的操作。

0.1.58：账号、设置与设备更新#

Windows 与 macOS 使用中文侧栏：设备网络、文件、诊断、设置、我的账号。账号页显示当前用户名，提供管理控制台、套餐管理和退出登录。设备登录授权页面也已改为中文。

设置提供允许传入连接、Celium DNS、子网路由及更新偏好，仅显示当前平台能实际生效的选项。Windows 商店版和移动端暂不支持接收子网路由；Mac 提供登录时启动、通知和 Dock 显示设置。关闭传入连接后，本机仍能主动访问允许的设备。

管理员可在控制台设备页查看版本并发起更新。目标设备必须先在本机开启“允许管理员更新此设备”；请求限定官方稳定版，显示排队、安装和结果，记录保留 30 天。Windows 官网版、macOS、Linux 由系统服务执行；商店版与移动端遵循商店或系统安装确认。

自动安装默认关闭，支持系统服务的平台可开启后每 6 小时检查一次。Linux 命令：

celium settings
celium settings --allow-incoming=true --accept-dns=true
celium settings --allow-remote-update=true --auto-install=true
celium update --install
celium admin --open

退出登录会清除当前账号的本地凭据并停止设备网络。普通断开连接无需退出登录。