treg serve 后台服务模式配置指南端口管理与开机自启快速上手【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtregOpenRouter for agent tools是面向 AI Agent 的工具注册表tools-registry它把各家数据 API 收进一个目录由服务端统一注入密钥、计费与审计。本文带你配置 treg 的后台服务模式serve mode一条命令让服务常驻后台、用TREG_PORT自由指定端口、再用 systemd 实现开机自启全程无需账号注册。什么是 treg 的后台服务模式treg 的 Web 服务通过模块方式启动执行python -m treg后内部会先执行数据库维护升级然后调用 uvicorn 以0.0.0.0监听端口默认18790入口逻辑位于 src/treg/main.py。与前台开发不同后台服务模式有三个核心诉求进程常驻关闭终端后服务不退出端口可控避开本机已占用端口或配合云平台注入的PORT开机自启机器重启后服务自动恢复官方自带的一键脚本 src/treg/web/selfhost.sh 就完整演示了这三点是学习配置的最佳参照。一键启动后台服务selfhost.sh 的工作原理官方自托管脚本会把整个注册表跑在本机无需注册、无需邮箱数据全部存放在~/.treg下的 SQLite 文件里并且只绑定 loopback 地址。它的关键设计可以直接复用到你自己的部署装依赖在~/.treg/venv虚拟环境安装tools-registry[server]生成密钥用python -m treg keygen生成 Fernet 密钥写入~/.treg/.env权限600保证重启后加密密钥不变后台拉起检测端口空闲后用nohup把服务丢到后台日志落在~/.treg/server.log健康探测循环请求GET /meta20 秒内不通则报错退出其中端口由TREG_PORT控制、家目录由TREG_HOME控制默认值分别是18790和~/.tregTREG_PORT18800 sh selfhost.sh # 改用 18800 端口启动如果你只是本地开发、想前后端一起管理也可以用 scripts/dev-local.sh 的up命令在 tmux 里同时拉起服务与前端 Vite 进程。端口管理3 个变量决定 treg 监听哪里treg 的端口优先级很清晰配置定义见 src/treg/config.py 与 src/treg/main.py优先级来源说明1环境变量PORT启动服务时生效Render / Heroku 等云平台会自动注入并做健康检查2环境变量TREG_PORTselfhost.sh 等本地脚本使用的开关默认187903兜底值两者都未设置时固定监听18790 小贴士本地跑服务时先执行curl http://localhost:18790/meta探活/meta是官方脚本使用的健康检查端点返回成功即代表服务就绪。常见端口操作速查换端口PORT19000 python -m treg改回默认取消PORT设置即可服务自动回到18790验证监听ss -ltnp | grep treg或再次请求/meta对外暴露修改TREG_PUBLIC_URL为你的公网地址OAuth 回调与公开链接都由它拼接开机自启用 systemd 守护 treg 服务自托管场景下最稳妥的做法是把服务注册成 systemd 单元。创建一个~/.config/systemd/user/treg.service或/etc/systemd/system/treg.service[Unit] Descriptiontreg tools-registry server Afternetwork.target [Service] WorkingDirectory/home/you/.treg EnvironmentFile/home/you/.treg/.env EnvironmentPORT18790 ExecStart/home/you/.treg/venv/bin/python -m treg Restarton-failure RestartSec5 [Install] WantedBymulti-user.target然后执行systemctl daemon-reload systemctl enable --now treg # 立即启动并设置开机自启 journalctl -u treg -f # 实时查看日志这套配置的好处✅崩溃自愈Restarton-failure让进程异常退出后 5 秒内自动拉起✅日志统一日志进 journald不再依赖server.log手动轮转✅优雅升级python -m treg upgrade可在重启服务前显式执行数据库迁移⚠️ 注意EnvironmentFile指向的.env里必须包含TREG_SECRET_KEY。密钥一旦更换之前加密的凭据将无法解密——请妥善备份该文件selfhost.sh 正是这样做的首次运行才生成密钥之后永不覆盖。关键环境变量速查表后台部署时这些TREG_前缀变量是高频配置项完整列表见 docs/context/ops/deploy.md变量作用典型值TREG_DATABASE_URL数据库连接串默认本机 SQLitesqliteaiosqlite:////~/.treg/treg.dbTREG_SECRET_KEYFernet 加密密钥务必持久化python -m treg keygen生成TREG_PUBLIC_URL对外访问地址用于回调与分享链接http://localhost:18790TREG_SINGLE_USER单人本地模式免登录、免注册true仅限 loopback SQLite 安全提示TREG_SINGLE_USERtrue只在本地 SQLite loopback 地址时生效——误把它带到公网 PostgreSQL 部署上是无效且危险的官方用single_user_ok门禁强制了这一约束。服务就绪后访问http://localhost:18790/app即可打开 Dashboard单人模式下已自动登录无需创建账号。常见问题排查症状原因解决办法Address already in use端口被占用换PORT或ss -ltnp找到占用进程/meta一直不通数据库迁移失败或密钥缺失看journalctl -u treg先手动执行python -m treg upgrade重启后密钥报错TREG_SECRET_KEY未持久化把.env挂进EnvironmentFile云平台 502未使用平台注入的PORT确认启动命令是python -m treg自动读取PORT延伸阅读部署与运维全景docs/context/ops/deploy.md云部署模板Web 服务 PostgreSQLdeploy/render.example.yaml一键自托管脚本src/treg/web/selfhost.sh服务入口与端口逻辑src/treg/main.py配置项定义src/treg/config.py配置完成后你的 treg 注册表就能 7×24 稳定运行开机自启、崩溃自愈、端口可控——把精力留给真正重要的事让 Agent 调用更多的工具。【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/28 20:16:43 · 阅读 1.2k treg serve 后台服务模式配置指南：端口管理与开机自启快速上手
treg serve 后台服务模式配置指南端口管理与开机自启快速上手【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtregOpenRouter for agent tools是面向 AI Agent 的工具注册表tools-registry它把各家数据 API 收进一个目录由服务端统一注入密钥、计费与审计。本文带你配置 treg 的后台服务模式serve mode一条命令让服务常驻后台、用TREG_PORT自由指定端口、再用 systemd 实现开机自启全程无需账号注册。什么是 treg 的后台服务模式treg 的 Web 服务通过模块方式启动执行python -m treg后内部会先执行数据库维护升级然后调用 uvicorn 以0.0.0.0监听端口默认18790入口逻辑位于 src/treg/main.py。与前台开发不同后台服务模式有三个核心诉求进程常驻关闭终端后服务不退出端口可控避开本机已占用端口或配合云平台注入的PORT开机自启机器重启后服务自动恢复官方自带的一键脚本 src/treg/web/selfhost.sh 就完整演示了这三点是学习配置的最佳参照。一键启动后台服务selfhost.sh 的工作原理官方自托管脚本会把整个注册表跑在本机无需注册、无需邮箱数据全部存放在~/.treg下的 SQLite 文件里并且只绑定 loopback 地址。它的关键设计可以直接复用到你自己的部署装依赖在~/.treg/venv虚拟环境安装tools-registry[server]生成密钥用python -m treg keygen生成 Fernet 密钥写入~/.treg/.env权限600保证重启后加密密钥不变后台拉起检测端口空闲后用nohup把服务丢到后台日志落在~/.treg/server.log健康探测循环请求GET /meta20 秒内不通则报错退出其中端口由TREG_PORT控制、家目录由TREG_HOME控制默认值分别是18790和~/.tregTREG_PORT18800 sh selfhost.sh # 改用 18800 端口启动如果你只是本地开发、想前后端一起管理也可以用 scripts/dev-local.sh 的up命令在 tmux 里同时拉起服务与前端 Vite 进程。端口管理3 个变量决定 treg 监听哪里treg 的端口优先级很清晰配置定义见 src/treg/config.py 与 src/treg/main.py优先级来源说明1环境变量PORT启动服务时生效Render / Heroku 等云平台会自动注入并做健康检查2环境变量TREG_PORTselfhost.sh 等本地脚本使用的开关默认187903兜底值两者都未设置时固定监听18790 小贴士本地跑服务时先执行curl http://localhost:18790/meta探活/meta是官方脚本使用的健康检查端点返回成功即代表服务就绪。常见端口操作速查换端口PORT19000 python -m treg改回默认取消PORT设置即可服务自动回到18790验证监听ss -ltnp | grep treg或再次请求/meta对外暴露修改TREG_PUBLIC_URL为你的公网地址OAuth 回调与公开链接都由它拼接开机自启用 systemd 守护 treg 服务自托管场景下最稳妥的做法是把服务注册成 systemd 单元。创建一个~/.config/systemd/user/treg.service或/etc/systemd/system/treg.service[Unit] Descriptiontreg tools-registry server Afternetwork.target [Service] WorkingDirectory/home/you/.treg EnvironmentFile/home/you/.treg/.env EnvironmentPORT18790 ExecStart/home/you/.treg/venv/bin/python -m treg Restarton-failure RestartSec5 [Install] WantedBymulti-user.target然后执行systemctl daemon-reload systemctl enable --now treg # 立即启动并设置开机自启 journalctl -u treg -f # 实时查看日志这套配置的好处✅崩溃自愈Restarton-failure让进程异常退出后 5 秒内自动拉起✅日志统一日志进 journald不再依赖server.log手动轮转✅优雅升级python -m treg upgrade可在重启服务前显式执行数据库迁移⚠️ 注意EnvironmentFile指向的.env里必须包含TREG_SECRET_KEY。密钥一旦更换之前加密的凭据将无法解密——请妥善备份该文件selfhost.sh 正是这样做的首次运行才生成密钥之后永不覆盖。关键环境变量速查表后台部署时这些TREG_前缀变量是高频配置项完整列表见 docs/context/ops/deploy.md变量作用典型值TREG_DATABASE_URL数据库连接串默认本机 SQLitesqliteaiosqlite:////~/.treg/treg.dbTREG_SECRET_KEYFernet 加密密钥务必持久化python -m treg keygen生成TREG_PUBLIC_URL对外访问地址用于回调与分享链接http://localhost:18790TREG_SINGLE_USER单人本地模式免登录、免注册true仅限 loopback SQLite 安全提示TREG_SINGLE_USERtrue只在本地 SQLite loopback 地址时生效——误把它带到公网 PostgreSQL 部署上是无效且危险的官方用single_user_ok门禁强制了这一约束。服务就绪后访问http://localhost:18790/app即可打开 Dashboard单人模式下已自动登录无需创建账号。常见问题排查症状原因解决办法Address already in use端口被占用换PORT或ss -ltnp找到占用进程/meta一直不通数据库迁移失败或密钥缺失看journalctl -u treg先手动执行python -m treg upgrade重启后密钥报错TREG_SECRET_KEY未持久化把.env挂进EnvironmentFile云平台 502未使用平台注入的PORT确认启动命令是python -m treg自动读取PORT延伸阅读部署与运维全景docs/context/ops/deploy.md云部署模板Web 服务 PostgreSQLdeploy/render.example.yaml一键自托管脚本src/treg/web/selfhost.sh服务入口与端口逻辑src/treg/main.py配置项定义src/treg/config.py配置完成后你的 treg 注册表就能 7×24 稳定运行开机自启、崩溃自愈、端口可控——把精力留给真正重要的事让 Agent 调用更多的工具。【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考