站点设置

站点设置决定未登录页面、认证流程、资源限制和运行时策略。只有拥有站点设置查看权限的管理员或超级管理员才能看到对应设置分类。

本页只讲界面上的开关、字段与可见效果；精确默认值、完整字段清单与匹配规则见站点设置参考。

访问系统设置

1. 以管理员身份登录。
2. 前往管理后台 > 站点设置（侧边栏「设置」分区）。
3. 从设置子导航选择分类。

设置分类：

• 常规
• 安全
• 通知渠道
• 存储
• 记忆
• 集成（登录身份源、邮件、Webhook、飞书、微信 iLink）

登录集成与内置服务配置分别授权：能改登录方式的人不一定能改邮件、Webhook 或消息集成，反之亦然。

常规设置

站点信息

配置站点名称、URL、描述、图标、默认语言和认证页布局：

修改后点击保存更改，公开页面立即使用新值。

主题与显示

配置默认主题模式、主色和品牌展示方式：

还可自定义主色前景、背景、卡片、侧边栏、导航栏、强调色与图表色等颜色。颜色使用十六进制格式，例如 #3b82f6。

语言设置

默认语言决定未登录访客看到的语言。登录用户可在个人设置中切换界面语言，通知消息也会按接收者的语言生成。

法律与合规

配置 ICP 备案、服务条款和隐私政策：

安全设置

注册与审批

密码策略

密码策略只约束新设置的密码；修改策略不会让已有密码失效。

密码过期：

会话与登录锁定

登录成功后失败计数清零。

没有「最大并发会话数」设置；并发会话由单一会话开关和会话有效期控制。

双因素认证

管理员可在用户管理里查看每个用户是否已绑定，并可为其重置或停用 TOTP。

人机验证

启用后，用户登录前需要完成一次点击验证；未完成或验证过期时登录被拒绝，页面提示需要重新完成验证。

网络访问限制：三个独立开关

安全页有三个相互独立的限制开关，均默认开启，可分别关闭而不影响其他策略：

关闭开关不会清空已保存的列表：列表仍可查看和编辑，重新开启并保存后立即恢复拦截。

模型端点白名单

模型供应商的请求地址必须与名单中的一项完全匹配（协议、主机名和端口一致，路径忽略）。名单默认预置 OpenAI、Anthropic、DashScope、硅基流动等已知供应商以及本机 http://localhost:11434，最多保存 200 条。

保存或测试使用新地址的模型前：

1. 前往设置 > 安全。
2. 将请求地址添加到模型端点白名单，每行一个。
3. 只填写协议、主机名和非默认端口，例如 https://gateway.example.com 或 http://ollama.internal:11434。
4. 保存安全设置，然后再次保存或测试模型。

名单外的地址会让模型保存或连接测试失败，提示端点不在白名单内。移除一项会立即阻止后续的模型发现、连接测试和对话请求，无需重启服务。

远程地址优先使用 HTTPS。仅对可信私有网络中的地址使用 HTTP，因为 API 密钥和模型流量会以明文发送。

出站网络白名单（内网访问豁免）

Clouisle 默认拒绝访问内网、回环和云元数据地址。以下操作在目标被拒绝时直接失败：

• 自定义 HTTP 工具
• 工作流中的 HTTP 请求节点
• 知识库的网址导入与网页预览
• 数据库工具的连接测试

需要调用内网 API、微服务或内网数据库时，在设置 > 安全 > 出站网络白名单中逐行添加被批准的目标：

其他行为：

• 最多 200 条，重复项自动去重；不含 . 的主机名（如 localhost）不能作为条目，请改用 IP 或网段。
• 留空等于拦截全部内网目标。
• 校验在每次请求时重新读取设置，改完立即生效，不需要重启服务。
• 关闭开关后，私网、回环和云元数据目标都可访问；URL 与端口的格式校验仍然执行，但它不是安全边界。关闭期间这些能力可被用于探测内网或读取云实例凭据，优先收紧白名单而不是关闭开关。

沙箱出口白名单

沙箱出口白名单是另一套策略，与上面的出站网络白名单互不生效：它只控制代码沙箱内程序的出网。

• 只接受精确主机名，逐条大小写不敏感匹配；通配符、IP 地址和网段一律拒绝。
• 默认 pypi.org、files.pythonhosted.org、pypi.python.org、registry.npmjs.org；最多 200 条，重复项自动去重。
• 空白名单阻断全部外网；只允许通过 HTTPS 的 443 端口访问名单内主机。
• 自定义包源必须使用 HTTPS，且主机名必须在名单内。
• 修改后对下一个任务生效，无需重启服务。
• 关闭开关只影响新任务；已运行任务保持原策略，文件系统隔离与资源限制仍然生效，列表保留可恢复。

通知设置

邮件（SMTP）

配置步骤：前往设置 > 集成 > 邮件，填写服务器信息，点击测试确认能收到测试邮件，再点击保存更改。

未配置或未启用 SMTP 时，邮件通知静默地只留在站内：不会报错，也不会事后补发。

外部通知渠道

外部通知渠道只有三个：邮件、Webhook 与飞书，在设置 > 集成中配置。旧版的钉钉、企业微信与 Slack 渠道已移除；微信 iLink 属于消息集成（Agent 会话与知识采集），不是通知渠道。

飞书通知是飞书集成上的显式能力，启用集成本身不会自动发送通知。详见飞书集成。

自动通知

自动通知（设置 > 通知渠道）控制哪些事件会创建通知，以及哪些外部渠道接收通知。详见通知与外部渠道。

邮件模板

通知偏好

通知的投递渠道由管理员全局配置，没有每用户通知偏好。普通用户不能自定义接收哪些通知。

用户可以在通知中心查看通知、标记单条或全部为已读，并按类型、级别、范围、未读状态和关键词筛选。通知范围分为全局、团队和指定用户三种。

管理员在设置 > 集成配置外部渠道，在设置 > 通知渠道的自动通知里选择事件类型。渠道只有在全局配置中选中且已启用/配置时才发送；未配置时通知只停留在站内。通知量大时，建议只启用需要跟进的类型，避免噪音。

可用事件类型包括团队成员与角色变更、团队模型授权变更、账户启用/停用、管理员重置密码、新注册待审批、知识库文档处理结果、工作流失败、工作流等待审批、API Key 即将过期/已过期、异常登录、账户锁定和密码变更。

记忆设置

记忆页控制后台记忆提取：用户在对话中产生的内容会在冷却时间后被提取为记忆，或在待处理轮次达到阈值时立即提取。Agent 自身也必须启用记忆；任一开关关闭都不会产生提取。

存储设置

文件存储

对象存储（S3 兼容）

选择对象存储后需要填写：

保存后上传与下载改用对象存储。

审计日志保留

超过保留期限的日志由管理员手动触发归档，归档后从数据库中删除。详见审计日志管理。

审计告警

设置页没有可用的审计告警功能：没有失败登录或批量删除的自动检测，也没有告警投递。需要安全告警时使用自动通知中的安全事件与外部渠道。

站点搜索

内置网页搜索工具由管理员在站点级统一配置，团队和 Agent 不再各自保存搜索密钥。

1. 前往管理台能力，找到内置的网页搜索工具。
2. 点击配置，打开站点搜索对话框。
3. 选择要启用的搜索引擎，填写对应凭据，设置默认引擎。
4. 点击测试确认能返回结果，再保存。

• 支持的引擎：Tavily、博查（Bocha）、SearXNG、DeepSeek。没有免密钥的搜索引擎，也不会在引擎失败时自动切换到其他供应商。
• 引擎可以在站点级逐个启用或停用；只有已启用的引擎会出现在工具配置中。
• 密钥保存后只显示为已配置，不会回显；留空表示保留原值，填写新值则替换。
• 关闭某个引擎后，使用该引擎的工具调用立即失败，需要在工具或 Agent 中改为其他已启用引擎。

引擎能力与限制见内置工具。

集成设置

登录身份源、邮件、Webhook、飞书与微信 iLink 在设置 > 集成统一管理。登录集成与内置服务分别授权：管登录的人负责 SSO 与登录方式，管内置服务的人负责邮件、Webhook、飞书、微信 iLink 以及消息投递记录。

全局 SSO 策略

在设置 > 安全的 SSO 分区配置：

登录集成与飞书登录

登录集成（OAuth2/OIDC、SAML2、CAS）在集成页创建与管理。飞书登录是飞书集成上的可选能力，显式开启后登录页才会显示飞书按钮。详见配置单点登录。

飞书通讯录同步

在设置 > 集成 > 飞书通讯录同步中，用应用的 App ID 与 App Secret 把选中飞书部门的成员同步为 Clouisle 账号。同步是单向的：不同步回飞书，飞书侧离职或停用不会自动禁用本地账号。

1. 在飞书开发者后台创建自建应用，授予通讯录读取权限，并把需要同步的部门加入应用的数据范围（含成员）；读根部门需要全员范围。
2. 需要读取公司名、成员 ID、姓名和邮箱：tenant:tenant:readonly、contact:user.employee_id:readonly、contact:user.base:readonly、contact:user.email:readonly。
3. 在飞书集成卡片保存 App ID 与 App Secret，浏览部门树并保存同步范围。顶层公司节点即根部门，选中它等于选全员；其他部门只含自身及下属部门。
4. 点击同步所选部门成员，导入账号并创建或更新对应团队（含公司团队）。结果报告新建、更新、跳过的账号数与新建团队数。

新账号没有本地密码，使用默认角色与默认团队。已有本地账号不会仅按邮箱合并；重复同步按飞书成员 ID 匹配更新，邮箱冲突时跳过。

同步失败先看卡片上的飞书原始错误码：

飞书 Agent 会话

飞书集成的 Agent 会话能力是显式开关，启用集成本身不会让机器人回答消息。开启能力、用户完成身份绑定并发布 Agent 后，用户可以在飞书中与该 Agent 对话。

接收消息有两种方式：

• HTTP 回调：把飞书事件订阅指向站点提供的回调地址，由飞书推送消息。
• 长连接：在飞书 Agent 会话配置中选择长连接，由平台主动连接飞书，无需公网回调地址。

两种方式可以同时使用。个人设置里可以暂停接收新消息、排队和未发送的回复；暂停不会删除历史会话。

飞书发送产物的上限：图片 10 MiB、MP4 30 MiB、其他文件 30 MiB。详见飞书集成。

飞书知识同步

飞书 Wiki 空间可以定时同步到指定知识库（仅超级管理员可配置）。选择来源空间与目标知识库后，设置同步间隔（1-43200 分钟），也可以随时点击立即同步。同步使用飞书集成中保存的应用凭据。

微信 iLink

微信 iLink 是单例集成，包含 Agent 会话与知识采集两个平台开关；个人还需要扫码授权，平台开关与个人授权相互独立。

• 绑定用途可选：无、知识采集、单个已发布 Agent，同一时间只有一个生效。
• 平台开关关闭时，暂停接收新消息、执行和回复；已有连接、凭据与待处理记录保留，重新开启后继续处理。
• 知识采集会把微信中的内容保存到知识库，并保留每次提交记录与支持的原件。

详见微信 iLink 集成。

团队设置

团队用于分组用户和资源（Agent、工作流和知识库）。团队管理员可以管理成员与团队基本信息；模型授权只能由超级管理员修改。

访问团队管理

有两个入口，权限与能力不同：

普通成员与观察者看不到管理全部团队入口，只能进入当前团队设置；且没有团队管理权限时，当前团队设置里也不能改成员。

团队信息

仅可编辑三个字段：

没有团队 slug 或自定义 URL，团队在界面上按名称引用。

模型授权

团队模型授权只能由超级管理员操作。 在管理当前团队 > 模型授权中，团队管理员和所有者看到的是只读视图：已授权模型、启用状态，以及「今日用量 / 限额」进度。限额由超级管理员分配，无限制 表示未设上限。

授权后的模型才会出现在团队的 Agent 与知识库模型选择器中。需要新增或调整授权时联系超级管理员。

成员管理

成员必须已有 Clouisle 账号；没有邮箱邀请或加入请求流程。

添加成员

1. 打开管理全部团队或管理当前团队并选择团队。
2. 打开成员标签。
3. 点击添加成员。
4. 选择现有用户和角色（管理员、成员或观察者；所有者不能在此分配）。
5. 确认。

改变成员角色：在成员列表中选择改变角色，选择新角色。只有团队所有者可以改变他人角色。

移除成员：在成员列表点击移除并确认。所有者不能被移除，也不能被其他成员移除。

离开团队：在成员中确认离开。所有者必须先转让所有权。

转让所有权：在成员中确认转让。前所有者变为管理员，新所有者获得完整控制权。

团队角色

角色固定为所有者、管理员、成员、观察者，没有每团队自定义角色。完整权限矩阵见团队与成员与角色与权限。

未实现的功能

以下团队级功能未实现：团队 slug / 自定义 URL、团队可见性与发现、邀请审批与邮箱域名限制、成员数量上限、团队资源配额、每团队密码/2FA/会话/IP 策略、团队 API 与速率限制、计费、数据保留/导出/删除、审计告警、自定义域名与品牌。

功能标志与其他设置

• 功能标志（启用/禁用 Agent、工作流、知识库）
• 邮件模板
• 安全响应头、CORS、IP 白名单
• API 速率限制
• 维护模式
• 设置导出/导入与恢复默认值

关键默认值

新站点默认：站点名称 Clouisle、认证页居中、主题跟随系统、显示图标和名称、允许注册、需要审批、邮箱验证开启、人机验证关闭、SSO 关闭、允许密码登录、会话 30 天、密码最短 8 位、连续失败 5 次锁定 15 分钟、知识库单文件上传 50MB、审计日志保留 365 天。三个网络访问限制默认全部开启。

生效时机

页面设置保存后通常立即影响公开站点和后续请求。模型端点、存储和部署相关的配置由服务端读取，按部署方式重启相关服务后生效。保存后建议用隐身窗口验证登录页和注册页。

安全原则

• 敏感凭据（邮件密码、SSO 客户端密钥、对象存储密钥、模型 API Key）只保存在服务端，界面不回显。
• 三个网络访问限制默认开启；关闭前确认影响范围，关闭后列表仍保留，可随时恢复。
• 模型端点按完整地址匹配；清空白名单会阻止所有模型请求。
• 沙箱出口白名单只接受精确主机名，空白名单阻断全部外网；它与出站网络白名单互不替代。
• 改为仅 SSO 登录前，先确认至少一个身份源可用，并保留管理员恢复路径。
• 修改审计日志保留天数前，确认归档路径位于持久存储并有备份。

字段级默认值与完整清单见站点设置参考。