# 安装 Talivia (https://talivia.com/zh-CN/docs/self-hosting/install)



## 准备事项 [#准备事项]

* [付款页面](https://talivia.com/zh-CN/app/settings/payments)中的 Talivia Lifetime 密钥。
* Node.js 22.12 或更新版本。运行 `node -v` 检查，必要时从 [Node.js](https://nodejs.org/) 安装当前 LTS 版本。
* 已验证电子邮箱的 Cloudflare 账户。

运行安装器无需 GitHub 或 npm 账户，也无需 Talivia 源码。

## 运行安装器 [#运行安装器]

在 macOS 终端或 Windows PowerShell 中运行：

```bash
npx --yes @talivia/lifetime-installer@latest --name talivia --lang zh-CN
```

## 安装过程 [#安装过程]

1. **许可证。** 在隐藏输入提示中粘贴密钥，创建资源前会验证密钥。
2. **Cloudflare 授权。** 在官方 Wrangler 打开的浏览器窗口中登录并授权，然后返回终端。
3. **账户。** 如有多个 Cloudflare 账户，选择安装目标。
4. **访问地址。** 复用现有 workers.dev 地址；新账户会尝试创建首个地址，请完成 Cloudflare 要求的验证。
5. **网站域名。** 可选域名用于第一个被追踪的网站，也可留空稍后添加。它不是[控制台自定义域名](https://talivia.com/zh-CN/docs/self-hosting/custom-domain)。
6. **部署。** 安装器绑定许可证、创建 `talivia-data`、应用迁移、下载签名应用并部署 Worker `talivia`。
7. **启动。** 保持终端打开，等待控制台与登录页面通过检查；Cloudflare 激活地址较慢时，可按提示继续等待。
8. **所有者。** 在打开的一次性表单中设置邮箱、至少 6 位密码和确认密码，保存这些凭据。
9. **网站。** 登录自己的控制台，添加网站并复制其中的追踪代码。

访问地址类似 `https://talivia.your-subdomain.workers.dev`，请保存并使用自己的应用地址。首次创建所有者后，设置表单不再创建其他账户，后续使用邮箱和密码登录。

## 重试与名称 [#重试与名称]

如安装退出，修复提示的问题后，以相同 Cloudflare 账户和 Worker 名称重新运行，安装器会恢复已有资源。不要删除数据库来重试。

如需其他 Worker 名称，修改 `--name` 后的值；更新时使用相同名称。其他问题请查看[故障排查](https://talivia.com/zh-CN/docs/self-hosting/troubleshooting)。
