站点配置

所属入口：管理 -> 系统设置 -> 站点配置。其他分组和生效时机见 系统设置。

如果站点要对外访问，先把这一组配对。

• 公开站点地址 填用户真正访问站点的 HTTP(S) 来源，在列表里每个输入框填一个，例如：

  https://drive.example.com
  https://panel.example.com

  每一项只填到来源层：协议、域名和可选端口。不要带路径，不要带 /api，也不要写通配符。系统会用这些来源生成分享页、邮件链接、WebDAV 地址、Office / WOPI 预览和后续回调所需的绝对 URL。留空时浏览器页面多数能按当前访问地址工作，但外部入口更容易生成错链接。正式部署建议明确配置公开站点地址。

  如果同一个实例通过多个域名访问，全部填进这个列表。AsterDrive 会根据当前请求的 Host 在列表里找精确匹配的来源；匹配上就用对应来源生成链接，匹配不上时使用第一项作为回退来源。

这不是 CORS 白名单

公开站点地址 表示“哪些公开入口属于这个 AsterDrive 实例”，也会参与 Cookie 写操作的 same-site CSRF 信任判断。它不会自动允许浏览器跨域调用 API。跨域访问仍然在 网络访问 -> 允许跨域来源 里单独配置。

• 站点标题、站点描述 影响登录页、分享页、应用页的标题与描述。
• favicon、浅色 Logo、深色 Logo 影响浏览器标签页、登录页、站点头部的品牌显示。
• 预览应用 给 Office、PDF、表格或其他文件提供额外的”打开方式”。内置预览器、外部 URL 模板、WOPI 打开方式在这里统一管理。
• WOPI 相关时效 只有接入 OnlyOffice 一类在线 Office 预览/编辑服务时才需要调。普通部署保持默认。

启用 WOPI 的推荐顺序

1. 先填对 公开站点地址
2. 到 预览应用 里启用已有应用，或通过 WOPI Discovery 导入新应用
3. 确认外部 Office / WOPI 服务能回连到 公开站点地址 生成的 /api/v1/wopi/...
4. 如果浏览器跨源调用 AsterDrive API 被拦，再去 网络访问 放行对应来源
5. 用真实的 docx / xlsx / pptx 试开一次，确认能保存回 AsterDrive

WOPI access token 有效期、WOPI 锁有效期、WOPI discovery 缓存时长 都在这一组里。只有在你已经接了 WOPI 服务、并且确实碰到会话过期或 discovery 更新不及时这类问题时，才需要手动调整。