NUC 家庭服务器

Intel NUC · Ubuntu 24.04 · Tailscale + Caddy

公网服务 公网可访问
Codex BridgeAI 对话接口（飞书/微信 Bot 后端）GET /health 飞书 Webhook飞书自建应用事件回调地址POST /webhook/feishu 微信 Webhook微信公众号消息回调地址GET/POST /webhook/wechat Codex API直接调用 Codex CLI（需 API Key）POST /api/codex · X-API-Key
内网服务 仅 Tailscale
Immich照片和视频自动备份 Nextcloud文件同步与共享 PaperlessOCR 文档库与搜索 MetaCubeXDVPN 节点与流量管理 通知中心服务器运行状态与故障通知 Cockpit系统管理 Web 面板
飞书 Bot 配置指南 新增

1. 创建应用：打开 https://open.feishu.cn/app → 创建企业自建应用 → 开启「机器人」能力

2. 事件订阅：请求地址填 https://nuc-server.taildad6ae.ts.net/webhook/feishu

3. 订阅事件：添加 im.message.receive_v1（接收消息）

4. 权限：开启 im:message 和 im:message:send_as_bot

5. 填凭证：SSH 到 NUC，编辑 /srv/projects/codex-bridge/.env，填入 FEISHU_APP_ID / FEISHU_APP_SECRET / FEISHU_VERIFICATION_TOKEN

6. 重启：sudo systemctl restart codex-bridge

7. 测试：在飞书 App 搜索机器人名，发消息即可触发 Codex CLI

直接调用 Codex API

通过 API Key 直接调用：

curl -X POST https://nuc-server.taildad6ae.ts.net/api/codex \

-H "Content-Type: application/json" \

-H "X-API-Key: YOUR_API_KEY" \

-d '{"prompt":"hello"}'

API Key 在 NUC 的 /srv/projects/codex-bridge/.env 文件中查看。

公网服务通过 Tailscale Funnel 暴露，自带 HTTPS。内网服务仅在连接 Tailscale 后可访问。