跳到主要内容

不使用 Docker 安装

使用 Docker 安装 Tianji 是最佳方式,这样无需考虑环境问题。

但如果你的服务器不支持 Docker,可以尝试手动安装。

需求

你需要:

克隆代码并构建

git clone https://github.com/msgbyte/tianji.git
cd tianji
pnpm install

pnpm build

准备环境文件

src/server 中创建一个 .env 文件

DATABASE_URL="postgresql://user:[email protected]:5432/tianji?schema=public"
JWT_SECRET="replace-me-with-a-random-string"

确保你的数据库 URL 是正确的,并且不要忘记事先创建数据库。

更多环境设置可以查看此文档 environment

如果可能,最好确保你的编码是 en_US.utf8,例如:createdb -E UTF8 -l en_US.utf8 tianji

运行服务器

npm install pm2 -g && pm2 install pm2-logrotate

# 初始化数据库迁移
cd src/server
pnpm db:migrate:apply

# 启动服务器
pm2 start ./dist/src/server/main.js --name tianji

默认情况下,Tianji 将运行在 http://localhost:12345

更新代码到新版本

# 切换到新的发布标签
cd tianji
git fetch --tags
git checkout -q <version>

# 更新依赖
pnpm install

# 构建项目
pnpm build

# 运行数据库迁移
cd src/server
pnpm db:migrate:apply

# 重启服务器
pm2 restart tianji

常见问题

安装 isolated-vm 失败

如果你正在使用 Python 3.12,可能会报如下错误:

ModuleNotFoundError: No module named 'distutils'

这是因为 Python 3.12 从内置模块中移除了 distutils。我们有一个不错的解决方案。

你可以将 Python 版本从 3.12 切换至 3.9 来解决此问题。

如何在 Brew 管理的 Python 中解决

brew install [email protected]
rm /opt/homebrew/bin/python3
ln -sf /opt/homebrew/bin/python3 /opt/homebrew/bin/python3.9

然后可以通过 python3 --version 检查版本。