招聘方

自托管部署

数据库初始化、Next.js 应用、面试中继进程和环境变量


一套部署由三部分组成:Next.js 应用(后台和候选人链接页)、面试中继进程(一个 WebSocket 端口,承载候选人会话、旁听通道、设备检测和调度模型的后台任务),以及 Supabase(数据库、登录、存储和实时订阅)。完整说明见仓库根目录的 README。

1

准备环境

Node.js 22.13 及以上和 npm;一个 Supabase 项目(云端,或用 npx supabase start 在本地启动)。

2

初始化数据库

数据库结构只有一份 supabase/migrations/001_initial_schema.sql:岗位、面试、转写、进展、调度记录、介入、接管、报告、录音录像、画面中断、每轮耗时、用户资料、支持请求和 AI 配置等表,以及行级安全策略、Realtime 发布和存储桶。云端项目执行 npx supabase db push,本地 npx supabase start 会自动执行。

3

配置环境变量

复制 .env.example 为 .env.local,填写 Supabase 地址和密钥、NEXT_PUBLIC_APP_URL(用于生成候选人链接)和 NEXT_PUBLIC_VOICE_RELAY_URL。两个文字模型、百炼语音和 TURN 也可以在部署后到「AI 配置」页面中配置(需要先把自己的账号设为 AI 配置管理员,见「AI 配置」)。

4

启动应用和中继

npm run build 后 npm run start 启动应用;另起一个进程运行 npm run dev:voice 启动中继(默认端口 8766,可用 VOICE_RELAY_PORT 修改)。中继需要 SUPABASE_URL 和 SUPABASE_SERVICE_ROLE_KEY,以便读取后台的 AI 配置和写入面试记录。启动时缺少文字模型或语音的必要配置,日志会给出中文提示。

HTTPS 与反向代理

  • 候选人必须通过 HTTPS 打开链接,浏览器才允许使用摄像头和麦克风。
  • 建议把中继挂在同一域名下的路径(例如 /ws/voice),由反向代理转发到中继端口,并把 NEXT_PUBLIC_VOICE_RELAY_URL 设为该路径;页面为 HTTPS 时浏览器会使用 wss://。
  • 反向代理需要支持 WebSocket 升级,并适当调大空闲超时。

WebRTC 与 TURN

旁听时候选人画面和双方语音、接管时招聘方的声音,都在两个浏览器之间直连传输,中继只转发信令。直连需要 ICE 服务器:

  • STUN(WEBRTC_STUN_URLS)帮助浏览器发现自己的公网地址,适用于大多数家庭和办公网络。
  • TURN(WEBRTC_TURN_URLS、WEBRTC_TURN_USERNAME、WEBRTC_TURN_CREDENTIAL)在无法直连时中转媒体。手机蜂窝网络普遍使用运营商级 NAT,部分企业网络是对称 NAT 或只放行 TCP/443,这些情况下 STUN 得到的地址无法被对端使用,只能经 TURN 中转。没有 TURN 时,招聘方仍能看转写、发私下提示和打字提问,但看不到画面、听不到声音,也无法接管。

coturn 部署要点

  • 部署在有 公网 IP 的服务器上;在 NAT 或云主机后面时设置 external-ip=公网IP/内网IP。
  • 开放 3478(UDP 和 TCP,turn:)和 5349(TCP,turns:,TLS),以及中继端口范围(例如 min-port=49152、max-port=65535 的 UDP)。
  • 为 5349 配置 TLS 证书(cert、pkey),用于只放行 TLS 的网络;也可以让 TLS 监听 443。
  • 使用 长期凭据:lt-cred-mech、user=用户名:密码、realm=你的域名,并把同一组用户名和密码填入 WEBRTC_TURN_USERNAME 和 WEBRTC_TURN_CREDENTIAL。
  • 建议同时填写 UDP 和 TLS 地址,例如 turn:turn.example.com:3478?transport=udp,turns:turn.example.com:5349?transport=tcp。
  • 禁止中转到内网地址(denied-peer-ip),避免 TURN 被用作内网代理。
TURN 凭据会下发到参与面试的浏览器。请使用专用于 TURN 的账号,不要复用其他系统的密码。修改后需要重启中继。