atoms项目一键部署到公网的核心是轻量穿透+自动化部署组合，无需公网ip或云主机经验；先本地启动服务并记录端口，再用localtunnel命令暴露为临时https链接，支持子域名定制；进阶可结合ucloud cli与星图api实现自有域名、持久化及全自动云部署。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Atoms 项目一键部署到公网，核心在于绕过传统“本地开发→打包→上传服务器→配置环境→开放端口”的长链路。它不依赖你有没有公网 IP、路由器权限或云主机经验，而是用轻量穿透 + 自动化部署组合，让一个本地文件夹直接变成可分享的公网地址。
确认本地服务已就绪
Atoms 本质是前端项目（如 Vue/React 构建产物），需先确保它能在本地跑起来：
- 进入项目根目录，运行
npm run serve或npm run dev启动开发服务器（常见端口：3000、8080、5173） - 若只是静态站点，可用 Python 快速验证：
python -m http.server 8000，然后访问http://localhost:8000 - 记下实际监听的端口号——这是后续穿透的关键参数
用 localtunnel 暴露本地服务
无需注册、不用配域名，一条命令生成临时公网 URL：
- 终端执行：
npx localtunnel --port 3000（把 3000 替换为你的真实端口） - 几秒后会输出类似
your url is: https://xyz789.localtunnel.me - 该链接即刻生效，任何人打开就能看到你的 Atoms 页面
- 如需固定子域名（方便演示或记忆），加
--subdomain yourname参数（是否可用取决于当前被占用情况）
进阶：绑定自有域名 + 持久化访问
localtunnel 的链接是临时的，若需长期稳定访问，可结合 UCloud CLI + 星图 API 实现全自动部署：
- 用 OpenCode 加载 Atoms 项目，调用星图 API 分析构建配置
- 自动触发 UCloud CLI 创建云主机、上传
dist文件、配置 Nginx - 部署完成后返回真实公网 IP 或绑定你自己的域名（如 atoms.yoursite.com）
- 整个过程无需手动登录云平台，全部由 Agent 在后台完成
对大多数个人项目、作品集、临时演示来说，localtunnel 方案足够快且零成本；若需长期运行、自定义域名或 HTTPS，再升级到云主机全自动部署即可。
