用户与权限
Web.Casa 支持多用户账户和基于角色的访问控制。每个用户拥有独立的凭据、可选的双因素认证，以及决定其访问范围的角色。
Web.Casa 定义了两种角色：
| 角色 | 访问级别 | 说明 |
|---|---|---|
| 管理员（Admin） | 完全控制 | 不受限制地访问所有功能和设置 |
| 查看者（Viewer） | 只读 | 可查看仪表盘、配置、监控指标和日志 |
管理员拥有对所有功能的完全访问权限：
- 主机管理 — 创建、编辑、删除反向代理主机
- 证书管理 — 签发、续期、管理 SSL/TLS 证书
- 用户管理 — 创建、编辑、删除用户账户并分配角色
- 系统设置 — 配置面板、Caddy 和环境变量
- 所有插件 — Docker、数据库、备份、监控、终端、文件管理器、防火墙、部署、AI、应用商店、MCP
- 审计日志 — 查看完整的操作记录
查看者拥有只读访问权限：
- 查看主机配置和状态
- 查看系统监控指标和仪表盘
- 浏览容器和数据库状态
- 查看审计日志
查看者不能创建、修改或删除任何资源，不能管理用户，不能访问网页终端，也不能更改设置。
提示： 权限在 API 层强制执行。即使查看者直接导航到受限页面，后端也会以 403 响应拒绝未授权操作。
当 Web.Casa 在空数据库上启动时：
- 显示初始设置页面
- 创建第一个用户账户，设置用户名和密码
- 该账户自动分配管理员角色
- 首个账户创建后，自助注册功能关闭
此后所有新用户必须由管理员通过设置 > 用户手动创建。
管理员在设置 > 用户中管理用户账户：
| 操作 | 说明 |
|---|---|
| 创建 | 添加新用户，指定用户名、密码和角色 |
| 编辑 | 修改用户密码或角色 |
| 删除 | 永久移除用户账户 |
规则：
- 不能删除自己的账户 — 此规则防止管理员意外锁定
- 密码最少 8 个字符
- 所有用户管理操作均记录在审计日志中
每个用户可在个人设置中选择启用 TOTP 双因素认证。设置步骤和恢复码详情请参阅认证与双因素。