DOMAIN_MANAGEMENT.md

域名管理功能说明

🛡️ 安全策略模式

白名单模式（推荐）

• 默认策略：拦截所有域名
• 允许访问：仅白名单内的域名可以创建短链和访问
• 安全性：最高，适合企业内部使用
• 使用场景：限制只能访问信任的网站

黑名单模式

• 默认策略：允许所有域名
• 拦截访问：黑名单内的域名无法创建短链和访问
• 安全性：中等，适合公开使用
• 使用场景：阻止已知的恶意网站

📋 域名规则管理

添加域名规则

1. 进入设置页面
2. 选择安全策略模式（白名单/黑名单）
3. 在输入框中输入域名（如：example.com）
4. 点击"添加"按钮

域名格式要求

• ✅ 正确格式：example.com、sub.example.com、github.com
• ❌ 错误格式：https://example.com、example.com/path

域名匹配规则

• 精确匹配：example.com 只匹配 example.com
• 子域名匹配：example.com 也匹配 sub.example.com、api.example.com

删除域名规则

• 鼠标悬停在域名标签上
• 点击出现的删除按钮（垃圾桶图标）

🔧 使用建议

初始设置（白名单模式）

1. 系统默认为白名单模式，所有域名都被拦截
2. 添加常用的可信域名到白名单：

   github.com
   google.com
   stackoverflow.com
   developer.mozilla.org
   

企业使用

• 添加公司官网和内部系统域名
• 添加常用的办公工具域名（如 Google Workspace、Microsoft 365）
• 定期审查和更新域名列表

个人使用

• 可以切换到黑名单模式，获得更大的灵活性
• 添加已知的恶意域名到黑名单
• 根据需要调整策略

⚠️ 注意事项

1. 白名单为空时：所有域名都会被拦截，无法创建任何短链
2. 策略切换：更改安全策略模式会立即生效
3. 域名验证：创建短链时会实时检查域名权限
4. 大小写不敏感：域名匹配不区分大小写
5. 实时生效：添加或删除域名规则后立即生效

🚀 快速开始

第一次使用

1. 访问设置页面
2. 确认当前为白名单模式
3. 添加你需要的域名到白名单
4. 返回首页测试创建短链

测试域名规则

1. 尝试创建一个白名单内域名的短链 ✅
2. 尝试创建一个白名单外域名的短链 ❌
3. 观察错误提示信息