系统初始化
第一次访问 OmniBox 时，系统会要求进行初始化配置。这是为了在浏览器的 localStorage 中存储代理服务器地址和其他配置信息。
初始化步骤
1. 打开 OmniBox 应用
访问您部署的 OmniBox 应用地址，系统会自动显示初始化界面。
2. 选择配置方式
OmniBox 提供三种配置方式：
方式一：JSON 数据输入
直接在文本框中输入 JSON 格式的配置数据：
json
{
"PROXY_BASE_URL": "https://your-proxy-domain.com/proxy/"
}方式二：上传配置文件
创建一个 config.json 文件：
json
{
"PROXY_BASE_URL": "https://your-proxy-domain.com/proxy/"
}然后点击上传按钮选择该文件。
方式三：远程地址导入
输入远程配置文件的 URL 地址：
https://your-config-server.com/config.json注意
远程配置文件必须支持 CORS，允许跨域访问。
3. 输入代理地址
在配置中输入您的代理服务器地址。代理地址格式示例：
bash
# Deno Deploy
https://your-project.deno.dev/proxy/
# Cloudflare Workers
https://your-worker.your-subdomain.workers.dev/proxy/
# Vercel
https://your-app.vercel.app/api/proxy/
# 本地服务器
http://localhost:8080/proxy/重要提示
代理地址必须以 /proxy/ 结尾，这是 OmniBox 识别代理路径的关键。
4. 完成初始化
点击 导入 按钮，系统会：
- 验证配置格式
- 将配置保存到浏览器的 localStorage
- 自动重新加载应用
- 进入 OmniBox 主界面
配置说明
基础配置项
| 配置项 | 说明 | 必填 | 示例 |
|---|---|---|---|
PROXY_BASE_URL | 代理服务器基础地址 | 是 | https://proxy.example.com/proxy/ |
完整配置示例
json
{
"PROXY_BASE_URL": "https://your-proxy-domain.com/proxy/",
"DANMU_API_URL": "https://your-danmu-api.vercel.app/87654321",
"M3U8_PROXY_URL": "https://your-m3u8-proxy.com/"
}修改配置
如果需要修改配置，可以通过以下方式：
方法一：清除浏览器数据
- 打开浏览器开发者工具（F12）
- 进入 Application 标签页
- 找到 Local Storage
- 删除 OmniBox 相关的存储项
- 刷新页面，重新进入初始化界面
方法二：直接修改 LocalStorage
- 打开浏览器开发者工具（F12）
- 进入 Application 标签页 → Local Storage
- 找到配置项并修改
- 刷新页面使配置生效
故障排除
问题：配置导入失败
可能原因：
- JSON 格式错误
- 代理地址格式不正确
- 网络连接问题
解决方案：
- 检查 JSON 格式是否正确（可以使用在线 JSON 验证工具）
- 确认代理地址以
/proxy/结尾 - 检查网络连接，确保可以访问代理服务器
问题：配置保存后仍然无法使用
可能原因：
- LocalStorage 被浏览器阻止
- 浏览器隐私模式限制
- 配置项名称错误
解决方案：
- 检查浏览器是否允许 LocalStorage
- 退出隐私模式
- 确认配置项名称正确（区分大小写）
问题：代理服务器无法访问
可能原因：
- 代理服务器未启动
- 代理地址配置错误
- 防火墙阻止
解决方案：
- 检查代理服务器是否正常运行
- 在浏览器中直接访问代理地址测试
- 检查防火墙和网络设置
测试配置
完成初始化后，可以通过以下方式测试配置是否正确：
测试代理功能
- 尝试搜索视频资源
- 如果能够正常加载数据，说明代理配置正确
查看控制台
- 打开浏览器开发者工具（F12）
- 查看 Console 标签页
- 如果有跨域错误，说明代理配置有问题
检查网络请求
- 打开 Network 标签页
- 查看请求是否通过代理服务器
- 确认请求 URL 格式正确