Docs · 部署
部署与接入
DBVeil 由控制台（控制平面）、运行在你服务器上的 Agent，以及负责公网转发的 Relay 组成。 按以下步骤即可在几分钟内把私有数据库接到云端应用。
准备工作
- 一台能访问目标数据库的服务器（Linux 推荐），可执行出站网络请求。
- 服务器已安装 Node.js 18 或更高版本。
- 一个 DBVeil 账号，并已创建工作区。
1 · 生成 Agent Token
登录控制台，进入 Agent 页面，填写 Agent 名称并生成 Token。 Token 默认 24 小时有效、仅展示一次，请及时复制。
2 · 安装 Agent
在数据库所在服务器执行一键安装命令（把 Token 替换为你刚生成的值）：
curl -fsSL https://www.dbveil.com/install.sh | DBVEIL_TOKEN=agt_live_xxx bash
脚本会下载并注册 Agent、安装 dbveil 命令，并在 Linux 上配置 systemd 服务。 更多命令与参数见 Agent 文档。
3 · 创建隧道
回到控制台的 隧道 页面，选择 Agent、服务类型（PostgreSQL / MySQL / Redis / TCP）、 本地地址与端口，系统会自动从 Relay 端口池分配一个固定公网端口。
dbveil expose postgres --host 127.0.0.1 --port 5432
4 · 连接你的应用
把控制台显示的公网地址填入应用的连接串。例如 PostgreSQL：
DATABASE_URL=postgresql://user:password@us1.dbveil.com:21001/app
该地址固定不变，可直接用于 Vercel、Netlify、Cloudflare Workers 等无服务器平台。 建议启用数据库自身的 TLS 以获得端到端加密。
常见问题
- 连接超时？确认 Agent 在线（控制台心跳正常）、隧道状态为「在线」， 且应用使用的是 Relay 公网地址而非本地地址。
- 端口变了？端口在创建隧道时分配后保持固定；删除隧道会释放端口。
- Agent 离线？检查服务器出站网络，或用
dbveil logs查看日志。