Pallas-Bot

外观

源码安装 ​

字数
782 字
阅读时间
4 分钟

目标：从源码跑起 Pallas-Bot，连接 PostgreSQL 并启动网页控制台
准备：git、Python 3.12+（或由 uv 安装）、一台可长期运行的机器
完成之后：源码目录可运行，控制台可访问；适合修改或参与开发的使用者

尚未安装 Python、uv 或 PostgreSQL 时，先完成 环境准备。

1. 获得可运行的源码目录 ​

bash
git clone https://github.com/PallasBot/Pallas-Bot.git
cd Pallas-Bot

进入目录后，能看到 pyproject.toml 和 config/pallas.example.toml，说明位置正确。

2. 安装项目依赖 ​

bash
uv run pallas sync

命令完成且未报错后，依赖已就绪。

可选：环境自检
bash
uv run pallas doctor

还没有 pallas.toml 时，doctor 提示缺配置是正常的，下一步补上即可。

3. 准备可连接的 PostgreSQL 数据库 ​

需要一个空库，首次启动时会自动建表。下面两种方式任选其一。

推荐：Docker 起库
bash
docker run -d --name pallas-pg \
  -e POSTGRES_USER=pallas \
  -e POSTGRES_PASSWORD=pallas \
  -e POSTGRES_DB=PallasBot \
  -p 5432:5432 \
  postgres:16-alpine

docker exec pallas-pg pg_isready
# 回复类似 accepting connections 即可
powershell
docker run -d --name pallas-pg `
  -e POSTGRES_USER=pallas `
  -e POSTGRES_PASSWORD=pallas `
  -e POSTGRES_DB=PallasBot `
  -p 5432:5432 `
  postgres:16-alpine

docker exec pallas-pg pg_isready

pg_isready 回复类似 accepting connections，说明数据库可以使用。 :::

备选：本机安装 PostgreSQL

建一个空库（示例名 PallasBot），账号能建表即可。权限说明见 deploy/pg。

可选：自动建库

在 [bootstrap.postgres] 加 auto_create_db = true（账号需有 CREATEDB）。上面 Docker 方式已经建好库时不必开。

4. 生成并填写启动配置 ​

复制一份配置：

bash
cp config/pallas.example.toml config/pallas.toml
powershell
copy config\pallas.example.toml config\pallas.toml

编辑 config/pallas.toml，至少让以下配置与上一步创建的数据库一致：

toml
[bootstrap]
host = "0.0.0.0"          # 仅本机可写 127.0.0.1
port = 8088
superusers = ["你的QQ号"]
db_backend = "postgresql"

[bootstrap.postgres]
host = "127.0.0.1"
port = 5432
user = "pallas"
password = "pallas"
db = "PallasBot"

注意：配置勿提交

pallas.toml 已在 .gitignore，不要提交到公开仓库。

配置保存后，Bot 已知道监听地址、超级用户和数据库位置。

5. 启动 Bot 并打开网页控制台 ​

bash
uv run pallas

这等价于 uv run pallas run unified。首次运行会创建数据库表，并在日志中打印网页控制台初始密码；这是正常现象。

  • 日志中没有数据库 connection refused，且已打印网页控制台初始密码，说明启动成功。密码也可在 data/pallas_console/ 找回。
  • 在浏览器打开 http://127.0.0.1:8088/pallas/，使用该密码登录。

提醒

本机用 127.0.0.1；挂到服务器把访问地址换成公网 IP / 域名，并放行 8088。

接下来：登录控制台并连接 QQ ​

先阅读 网页控制台 登录并完成首次设置，再按 连接 QQ 扫码连接账号。