Atoms_Cloud一键部署项目完整流程

必须使用官方预构建包部署Atoms Cloud：先确认Ubuntu 24.04/CentOS Stream 9系统，安装基础工具，创建~/atoms-cloud目录并进入；下载v3.8.2包并SHA256校验；解压后chmod +x授权；运行init生成config.yaml和证书，导入license.key，最后nohup启动服务。

要在服务器上快速启用Atoms Cloud平台并运行首个项目，必须跳过手动编译和依赖排查环节，直接使用官方提供的预构建部署包完成初始化。这要求你严格按路径顺序执行命令，任何目录偏差都会导致配置文件加载失败。

准备运行环境

成功登录服务器后，首先要确认系统是否为Ubuntu 24.04 LTS或CentOS Stream 9——Atoms Cloud的二进制包仅在这两个发行版上经过验证。可通过运行cat /etc/os-release | grep PRETTY_NAME进行检查，如果结果不匹配，那么必须立即更换镜像或重新安装系统。

执行 sudo apt update && sudo apt install -y curl wget gnupg ca-certificates 安装基础工具。注意：不要安装 docker 或 nodejs，Atoms Cloud 自带精简运行时，额外安装会引发端口冲突和权限覆盖。

创建专用部署目录：mkdir -p ~/atoms-cloud && cd ~/atoms-cloud。这一步不可省略，

下载并校验部署包

运行以下命令一次性下载最新版部署包（当前版本 v3.8.2）：

curl -L https://release.atomgit.com/atoms-cloud/latest/linux-amd64/atoms-cloud.tar.gz -o atoms-cloud.tar.gz

立即校验 SHA256 值，防止中间劫持：

echo "a1f9b8c7e2d6f5a4b3c8d9e7f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b atoms-cloud.tar.gz" | sha256sum -c

若输出不是 atoms-cloud.tar.gz: OK，请删除文件并重试。校验失败的包禁止解压，它可能已被篡改。

解压并授权执行

执行 tar -xzf atoms-cloud.tar.gz 解压，生成 atoms-cloud 可执行文件与 templates/ 目录。

赋予执行权限：chmod +x atoms-cloud。

这一步看似简单，但若用 sudo chmod 错误地给整个目录递归赋权，会导致后续 init 流程拒绝写入 runtime 子目录——Atoms Cloud 会检测父目录权限是否为 755 且非 root 所有。

首次初始化与服务启动

第一步：生成初始配置

./atoms-cloud init --domain myapp.example.com --port 8080

该命令会创建 config.yaml 并在 certs/ 下生成自签名证书。--domain 参数必须是真实可解析域名或本地 hosts 已映射的名称，填 localhost 将导致 WebSocket 连接被浏览器拦截。

第二步：导入许可证

将你收到的 license.key 文件放入当前目录，然后运行：./atoms-cloud license import license.key。

第三步：启动服务

nohup ./atoms-cloud serve > logs/out.log 2>&1 &

服务一经启动，马上检查日志尾部：tail -n 20 logs/out.log 。若能看到 HTTP server started on :8080 与 WebSocket gateway ready 这两行，便表明部署已成功。此时打开浏览器，访问 http://your-server-ip:8080 ，就能进入控制台啦。