应用集成

「应用集成」把 OneTap 部署的应用接入外部基础服务，目前提供两类能力：

• 网络集成：通过 Lucky 或 Nginx Proxy Manager + DDNS-Go 自动创建反向代理、申请证书、维护动态域名
• 认证集成：把已部署应用的账号密码同步到 Vaultwarden

页面入口在左侧导航「系统 → 应用集成」，仅管理员可修改配置。

网络集成

页面顶部提供两套互斥的网络方案：

方案	适用场景
Lucky	反向代理 + DDNS 一体，配置集中在 Lucky
Nginx Proxy Manager + DDNS-Go	反向代理与 DDNS 分开部署，适合已有 NPM 的环境

切换方案不会删除旧规则

两套方案互斥，但切换只影响 OneTap 后续写入的位置，不会删除旧系统中已经创建的代理、证书或 DDNS 任务。需要清理时请到对应系统手动删除。

连接配置

打开「启用」开关后填写服务地址与登录信息，并点击「测试」验证连接：

• Lucky：服务地址、登录账号、登录密码
• Nginx Proxy Manager：服务地址、登录邮箱、登录密码、SSL 证书策略（不启用 HTTPS / 自动申请 Let's Encrypt / 已有证书）、是否强制 HTTPS
• DDNS-Go：服务地址、登录账号、登录密码

页面会显示最近一次测试结果。建议先完成连接测试，再创建代理和 DDNS 任务。

内网地址

反向代理需要知道应用的内网访问地址。可以在「内网地址」下拉中选择当前访问地址、网卡地址，或选择「自定义…」手动填写；网卡变化后可点击「重新识别内网地址」。

反向代理与域名

表格展示已配置的代理：应用、域名、后端地址、端口（Lucky）、HTTPS 状态与操作。没有配置时会显示「还没有反向代理配置」。

点击「新建代理」打开配置对话框：

字段	说明
应用	可从已部署应用/实例中选择，也可选择「自定义应用」并填写应用名称与后端地址
域名	每行一个，支持内网域名与通配符
后端地址	支持 IPv4 与 IPv6
Lucky 监听端口 / 协议	选择监听端口与双栈、仅 IPv4、仅 IPv6
HTTPS	可启用 HTTPS、HTTP 自动跳转，并选择证书自动匹配或自动添加证书（自动 / 自签名 / 公网 ACME）
NPM 证书	选择已有证书，并设置强制 HTTPS

保存后平台会调用对应系统应用配置，失败时会在弹窗中返回原因。编辑已有代理会更新原规则，删除只影响对应代理。

自定义后端

可以选择「自定义应用」，把没有通过 OneTap 部署、但能从内网访问的服务也接入反向代理。

DDNS 动态域名

DDNS 区域用于把域名解析保持到当前公网 IP。配置项包括：

• DNS 服务商：Lucky 侧支持阿里云、Cloudflare、DNSPod、腾讯云、华为云、百度云、京东云、火山引擎、Porkbun、GoDaddy、NameSilo、Duck DNS、Dynv6、FreeMyIP、Spaceship、Vercel 等；NPM 侧支持 Cloudflare、阿里云、DNSPod、腾讯云、华为云、百度云、Porkbun、GoDaddy、Dynv6 等
• 账号 ID / API 密钥：服务商的 API 凭据
• IPv4 / IPv6 任务：分别启用；每条任务可配置获取 IP 方式（请求 URL / 网卡）、检查间隔、IP 查询地址、网卡、IP 筛选正则
• 域名：可手动填写，也会自动收集反向代理中使用的域名；手动域名在同步时保留

任务表显示任务类型、域名、当前地址、状态（已启用/已停用/同步成功/无变化/同步失败/尚未同步）、上次与下次同步时间。可以「刷新状态」「保存 DDNS」和删除任务。

查看已保存的 API 密钥时需要再次输入当前 OneTap 登录密码，避免会话被他人直接读取凭据。

认证集成

认证集成用于把已部署应用的账号密码写入 Vaultwarden，便于统一保管。

配置

填写并保存：

• 启用认证集成
• 服务地址（如 http://192.168.1.23:8080）
• 登录邮箱
• 主密码

点击「测试连接」验证登录。主密码只用于登录并派生加密密钥，不会出现在同步条目中。

账号限制

暂不支持开启两步验证或使用 Argon2id KDF 的 Vaultwarden 账号；如需同步，请使用兼容的账号配置。

同步已部署应用

「已部署应用」表列出应用、访问地址、账号、密码状态和同步状态，可以逐个点击「同步」，或使用「同步全部」。同步条目会命名为「OneTap · 应用名」，重复同步会更新原条目而不是新建。

底部显示已同步应用数量。还没有部署应用时，会引导前往应用市场或自动化页面。

常见问题

测试连接失败 确认 OneTap 容器能访问目标服务地址。服务地址不能填写目标系统容器内的 localhost，应填写 OneTap 容器可访问的宿主机或容器网络地址。

代理创建成功但访问不到应用 检查后端地址与端口是否指向应用真实监听地址、域名是否已解析到反向代理，以及 HTTPS 证书是否匹配。Lucky 的监听端口需要与路由器/防火墙放行规则一致。

DDNS 状态一直是「无变化」 表示当前解析已经是最新地址，不需要更新；只有公网 IP 变化时才会触发同步。若显示「同步失败」，优先检查 API 凭据权限和域名所属账号。

同步到 Vaultwarden 的条目重复 正常重复同步会更新「OneTap · 应用名」条目；如果手动改过条目名称，平台可能无法识别，建议删除旧条目后重新同步一次。