Bun 服务器 — PPanel Edge

运行包含静态界面、PostgreSQL、Redis、存储和后台任务的 Bun 服务端产物。

使用 Bun >=1.3.14。先完成构建、环境、数据库安装与向导，复制完整的 dist 目录。Bun 服务相对于工作目录读取 dist/client。

cd /opt/ppanel-edge/apps/api
bun --env-file=/etc/ppanel-edge/api.env dist/server/bun.mjs

源码工作区也可通过 bun run --cwd apps/api start:bun 启动轻量入口并读取应用环境文件。dev 仍是开发监听模式；生产环境文件必须明确设置生产模式。

服务使用与 Workers、Node 相同的业务代码，官网位于 /、门户位于 /app/、后台位于 /admin/，同时提供 API。哈希资源使用长期不可变缓存，HTML 需要重新验证，缺失资源返回 404，后台深链不会返回门户入口。

Redis/Valkey 使用 Bun 内置客户端；自动模式下未配置 Redis 地址则使用 PostgreSQL。存储使用独立授权的 S3 桶，SMTP 与 HTTP 邮件在后台配置。默认从套接字读取客户端地址，使用可信代理请求头时需明确配置。

使用 Bun systemd 单元或容器目标。检查 /healthz，完成安装向导后检查 /readyz。在预发布验证邮件、支付、订阅、上传与后台任务。SIGTERM 等待请求和任务完成，允许进程使用 17 分钟退出。

alpha 镜像使用 ghcr.io/herta-network/ppanel-edge:alpha；建议固定明确版本控制升级。稳定发布还提供 latest。两套 Redis/Valkey、切换镜像与回滚见 Docker Compose。