托管

在 Railway 上运行

Railway 致力于为人类构建软件开发基础设施。它的核心理念是,构建软件应当是“取所需,舍所不用”,而现有的软件开发工具过于复杂,难以满足当前及未来开发者的需求。因此,Railway 负责构建、部署、扩展和管理基础设施,从开发到生产环境一站式服务!

Railway 提供免费的托管服务,你可以通过点击按钮部署 Umami,并设置一个 PostgreSQL 数据库,从而轻松拥有自托管版本。

设置网站和数据库#

Railway 按钮(推荐)#

部署到 Railway

点击上方按钮,即可部署自托管版本的 Umami 网站,并自动配置 PostgreSQL 数据库。

部署完成后,你可以访问 Umami 仪表盘,设置想要跟踪分析的网站。

你可以在项目仪表盘中找到访问链接,运行 railway open 即可打开。

从 Fork 的仓库在 Railway 上运行#

前述方法是快速且简便地在 Railway 上运行 Umami 的方式。但这会在你的 GitHub 账户下创建一个带有单次提交的新仓库。你或许希望使用 Fork 的仓库,方便从 Umami 源仓库接收更新或提交 PR。

设置 Railway 项目#

  1. Fork Umami 仓库。
  2. 在 Railway 上创建一个与 GitHub 关联的账户。
  3. 如果你愿意,在关联 GitHub 账户时可以仅授予 Railway 访问你的 Umami fork 仓库的权限。
  4. 从仪表盘页面点击 New Project > Deploy from repo。
  5. 选择你 fork 的 Umami 仓库,并选择 master 分支。
  6. 添加第一个变量 PORT,将其值设为有效端口号(例如:3000)。点击 Add。
  7. 添加第二个变量 DATABASE_TYPE,将其值设为 postgres。点击 Add。
  8. 添加第三个变量 HOSTNAME,将其值设为 0.0.0.0。点击 Add。
  9. 点击 Deploy。

初次部署会失败,需继续执行以下步骤。

数据库和部署#

  1. 关闭设置侧边栏,点击 New,选择 Database,再选择 Add PostgreSQL。
  2. 在仪表盘选择你的 Umami 服务,进入 Variables 标签页,点击 New Variable。
  3. 点击 Add Reference,从你的 Postgres 数据库变量中选择 DATABASE_URL,点击 Add。

添加数据库后会触发重新部署,点击应用链接应能进入 Umami 登录页。

故障排除

如果 Railway 仪表盘提示 Your project has no deploys。

  1. 点击左下角的 Set up your project locally。

  2. 在 umami 根目录,按照弹窗提示操作。

  • 使用 railway login 登录 Railway 账户
  • 使用 railway link 关联项目
  • 使用 railway open 打开项目仪表盘
  • 使用 railway up 上传并部署项目
  1. 按照 入门 指南中的登录步骤继续,并务必更改默认密码。
注意事项