出门后想连接办公室电脑，手机上想查看家中服务器的服务，开发时需要访问另一台电脑的测试环境------设备越来越多，地址和网络环境却越来越难管理。
这些场景的共同需求很具体：找到自己的设备，知道它是否可用，然后用熟悉的工具访问它。
Celium 是一款面向个人设备、家庭服务和小团队的跨平台网络连接与设备管理客户端。它将设备连接、状态查看和常用排障入口放在一起，让 Windows、macOS、Linux 与 Android 设备之间的远程访问更容易开始。
一、Celium 能解决哪些实际问题？
1. 远程办公：连接自己的工作电脑
将办公电脑和随身设备加入同一设备网络后，可以在客户端中找到目标设备，再使用已有的远程桌面工具访问。
网络连接、远程桌面服务和设备权限分别承担不同职责。目标电脑仍需开启对应服务，并允许你访问；Celium 提供设备间的连接与管理能力。
2. 开发运维：更方便地访问服务器与测试环境
对于开发者来说，常见需求包括 SSH 登录服务器、访问内部 Web 服务，以及检查某个测试环境的端口是否工作。
Celium 支持查看设备地址、使用 MagicDNS 名称，并通过客户端诊断入口检查设备隧道与应用端口。服务变多以后，也可以通过搜索和收藏减少反复查找。
3. 家庭服务：访问自己部署的设备与应用
家中的电脑、文件服务或家庭服务器，不一定与你的手机处于同一个局域网。
将有权使用的设备连接起来后，你可以继续使用这些设备上原本运行的应用。具体可访问哪些服务，取决于应用设置、防火墙及访问策略。
4. 小团队协作：设备加入与访问范围可管理
团队使用时，除了"能连接"，还需要清楚设备是谁的、是否经过批准，以及成员可以访问什么。
Celium 提供浏览器设备授权、成员与设备管理、访问策略等能力，帮助管理员管理设备加入和访问范围。不同平台与版本的具体支持，以当前客户端和产品文档为准。
二、几个值得关注的客户端功能
设备列表自动刷新，常用设备快速找到
客户端会自动读取设备状态，显示设备名、地址、连接方式及在线情况。
设备多的时候，可以按名称、IP、MagicDNS 域名或系统搜索；再结合"仅在线"筛选和收藏，集中查看常用设备。复制地址后，就可以转到 SSH、远程桌面或其他应用继续工作。
MagicDNS：用名字访问设备
相比记住一串地址，用设备名称访问更符合日常习惯。MagicDNS 为同一设备网络中的访问提供名称解析能力。
例如，在名称解析和访问权限已经配置好的环境中，开发者可以使用类似下面的命令：
bash
ssh user@dev-box这里的 dev-box 是示意设备名，需要换成你实际的设备名称；目标设备仍需运行 SSH 服务。名称解析成功和服务可以访问，是两个需要分别确认的环节。
加密连接，优先尝试直连
Celium 为设备间通信提供加密连接，并优先尝试直连。无法建立直连时，可以使用经过设备认证的中继路径。
实际连接方式和速度取决于网络环境、设备位置及可用路径。客户端显示的连接方式可以帮助判断当前使用直连还是中继，不应把某一种路径理解成固定速度保证。
普通上网沿用原网络
默认模式下，Celium 用于连接设备网络，普通互联网访问保持原来的网络连接。
有需要时，可以选择自己有权使用、且经过管理员批准的出口设备；也可以切回"普通上网"。选择出口会改变相关流量的转发路径，因此需要明确出口设备是否在线、是否允许使用，以及访问策略是否符合自己的需求。
连接诊断：把"设备在线"与"应用可用"分开看
"在线"是设备状态的重要信息，但目标服务是否可访问，还与应用、端口、防火墙和策略有关。
客户端提供设备隧道测试及常用 TCP 端口测试入口。例如，SSH 常用 TCP 22，HTTPS 常用 TCP 443，远程桌面常用 TCP 3389。
有了这些入口，排查时可以先确认设备网络，再检查服务端口，避免只看到"在线"就反复尝试同一个应用。
三、从两台设备开始，建立第一次连接
初次使用，建议只选择一台主设备和一台需要访问的设备，先跑通一个明确的场景。
- 安装对应平台的客户端。 根据设备系统选择 Windows、macOS、Linux 或 Android 版本。
- 登录并确认设备授权。 在浏览器授权页面核对设备信息，确认加入的是自己的设备。
- 让另一台设备加入同一网络。 在客户端设备列表中查看它的名称和地址。
- 确认目标服务已经启动。 例如 SSH、远程桌面或自己的应用服务。
- 使用熟悉的工具访问。 遇到问题时，先使用客户端诊断确认隧道与应用端口。
各平台的安装与体验有所差异：macOS 提供 Apple Silicon 和 Intel 安装包，Linux 提供 APT 安装方式，Android 提供 APK。Windows 官网安装版应打开 Celium Desktop ；celium.exe 是命令行工具。
Windows Microsoft Store 版采用 Windows 原生 VPN API 集成，更新由 Microsoft Store 管理。截至本文发布时，商店版正在认证，发布状态以项目说明为准。
四、遇到"已连接，但访问不了"，怎样排查？
可以按下面的顺序检查：
| 检查环节 | 要确认的事情 |
|---|---|
| 本机连接 | 当前客户端是否已连接，是否有健康信息提示 |
| 目标设备 | 设备是否在线，是否处于休眠或已断开状态 |
| 设备隧道 | 客户端的隧道连接测试是否通过 |
| 应用端口 | 目标服务是否已启动，使用的端口是否正确 |
| 权限与策略 | 防火墙和访问策略是否允许当前设备访问 |
| 名称解析 | 使用设备地址可以访问、使用名称失败时，进一步检查 MagicDNS |
例如，隧道测试通过而远程桌面端口测试失败，就应进一步确认目标电脑的远程桌面服务和防火墙设置。隧道连接正常，并不能自动打开目标电脑上的服务端口。
这个排查方式也适合团队沟通：报告问题时，附上系统与客户端版本、具体操作、预期结果及经过脱敏的诊断信息，会比一句"连不上"更容易定位。
五、GitHub 公开了哪些内容？
Celium 已公开 Microsoft Store 客户端界面与 Windows 平台封装的部分源码，便于开发者了解产品交互和平台集成方式。
公开内容包括：
- Windows 桌面界面与启动脚本。
- 状态自动刷新、设备搜索、收藏和诊断操作入口。
- 商店启动参数处理与 Windows 原生应用激活封装。
- Windows 连接配置管理封装。
- 使用占位身份信息的 MSIX 清单示例。
- 客户端架构说明、公开范围说明与产品展示图片。
该仓库属于部分源码公开展示。 网络核心、协调服务器、中继服务器及生产配置没有包含在其中，因此无法仅凭这份源码独立构建完整客户端。仓库也未附加通用开源许可证，不能把"可查看源码"直接等同于"完整产品开源"。
对产品感兴趣，可以先在项目 README 查看界面和安装说明；对客户端实现感兴趣，可以从界面代码与平台封装入手。
六、适合怎样开始使用？
如果你有一台经常需要远程访问的电脑，或已经运行了一台家庭服务器，Celium 的价值比较容易验证：先连接两台设备，再访问一个已经存在的服务。
接下来，可以收藏常用设备、用 MagicDNS 名称替代反复查找地址，并通过诊断工具确认连接状态。团队使用时，再逐步配置设备授权、成员权限和访问策略。
欢迎在 GitHub 反馈具体使用场景，例如设备较多时如何组织列表、移动网络下如何更清楚地提示连接状态，以及哪种诊断结果最有帮助。反馈时请勿公开密码、令牌、密钥或未经脱敏的完整设备信息。
项目介绍、产品展示与安装说明入口：
本软件为网络连接与设备管理客户端，不提供网络节点、互联网接入、境外网络访问或通信线路服务。用户需自行配置并使用其合法拥有或有权使用的网络资源。