常见问题

这里收集了 OmniBox 使用过程中的常见问题和解决方案。

安装部署

Q: 如何选择部署方式？

A: 根据您的需求选择：

• 个人使用/测试：Cloudflare Pages 或 Vercel（免费，简单）
• 生产环境：Docker 部署（稳定，功能完整）
• 静态托管：云存储部署（成本低，适合纯前端）

Q: 部署后无法访问？

A: 检查以下几点：

1. 确认服务正常运行
2. 检查端口是否正确
3. 验证防火墙设置
4. 查看服务日志

Q: 如何更新到最新版本？

A:

Docker 部署：

docker pull lampon/omnibox:latest
docker stop omnibox
docker rm omnibox
# 重新运行容器

其他部署方式：

• 重新构建并部署项目
• 或使用 Git 拉取最新代码后重新部署

配置问题

Q: 代理服务器必须配置吗？

A: 是的，由于浏览器的同源策略限制，必须配置代理服务器才能正常使用 OmniBox。

Q: 代理地址格式是什么？

A: 代理地址必须以 /proxy/ 结尾，例如：

• https://your-proxy.com/proxy/
• http://localhost:8080/proxy/

Q: 如何测试代理是否正常工作？

A: 访问以下地址测试：

https://your-proxy-domain.com/proxy/https://httpbin.org/get

如果返回 JSON 数据，说明代理工作正常。

Q: 初始化配置在哪里修改？

A:

1. 清除浏览器数据：删除 LocalStorage 后重新初始化
2. 直接修改：在浏览器开发者工具中修改 LocalStorage
3. 重新导入：使用新的配置文件重新导入

使用问题

Q: 视频无法播放？

A: 可能的原因和解决方案：

1. 代理服务器问题

   • 检查代理服务器是否正常运行
   • 测试代理地址是否可访问

2. 视频源问题

   • 尝试切换其他视频源
   • 检查视频源是否可用

3. 浏览器问题

   • 更新浏览器到最新版本
   • 尝试使用其他浏览器
   • 清除浏览器缓存

4. 网络问题

   • 检查网络连接
   • 尝试使用 VPN 或代理

Q: 如何跳过片头片尾？

A:

1. 进入设置页面
2. 找到 播放设置
3. 设置片头跳过时间（秒）
4. 设置片尾跳过时间（秒）
5. 保存配置

Q: 历史记录在哪里？

A:

• 在主界面点击 历史记录 按钮
• 可以看到所有观看过的视频
• 点击视频可以继续观看

Q: 如何清除历史记录？

A:

1. 进入历史记录页面
2. 点击 清除历史 按钮
3. 确认清除操作

Q: 如何添加采集站？

A:

1. 进入设置页面
2. 找到 采集站管理
3. 点击 添加采集站
4. 输入采集站 URL 和名称
5. 保存并测试

弹幕功能

Q: 弹幕无法显示？

A: 检查以下几点：

1. 是否配置了弹幕 API
2. 弹幕 API 地址是否正确（包含 TOKEN）
3. 弹幕 API 服务是否正常运行
4. 查看浏览器控制台是否有错误

Q: 如何部署弹幕 API？

A: 推荐使用 Vercel 部署：

1. Fork danmu_api 项目
2. 部署到 Vercel
3. 设置环境变量 TOKEN
4. 获取 API 地址并配置到 OmniBox

详细步骤请参考 弹幕API配置。

M3U8 代理

Q: M3U8 代理是必须的吗？

A: 不是必须的，但建议配置：

• 可以过滤广告
• 可以加速播放
• 可以解决某些访问限制

Q: 如何配置 M3U8 代理？

A:

1. 部署 M3U8 代理服务
2. 在 OmniBox 设置中配置代理地址
3. 格式：https://your-m3u8-proxy.com/?url={M3U8_URL}

详细步骤请参考 M3U8代理设置。

技术问题

Q: 出现跨域错误？

A:

1. 确认已配置代理服务器
2. 检查代理服务器 CORS 设置
3. 验证代理地址格式正确
4. 清除浏览器缓存后重试

Q: 请求超时？

A:

1. 检查网络连接
2. 尝试更换代理服务器
3. 检查目标采集站是否可访问
4. 增加请求超时时间

Q: 数据丢失？

A:

Docker 部署：

• 检查数据卷是否正确挂载
• 确认容器重启后数据卷仍然存在

其他部署：

• 检查数据库文件位置
• 确认备份策略

性能问题

Q: 播放卡顿？

A:

1. 检查网络连接速度
2. 尝试配置 M3U8 代理加速
3. 切换其他视频源
4. 降低视频清晰度

Q: 加载速度慢？

A:

1. 使用 CDN 加速
2. 配置缓存策略
3. 优化代理服务器性能
4. 使用更快的部署方案（如 Cloudflare）

其他问题

Q: 如何反馈问题？

A:

• 在 GitHub Issues 提交问题
• 提供详细的错误信息和复现步骤
• 包含浏览器和控制台日志

Q: 如何贡献代码？

A:

1. Fork 项目
2. 创建功能分支
3. 提交更改
4. 创建 Pull Request

Q: 项目是免费的吗？

A:

是的，OmniBox 是开源项目，完全免费使用。

Q: 支持哪些浏览器？

A:

支持所有现代浏览器：

• Chrome/Edge（推荐）
• Firefox
• Safari
• Opera

建议使用最新版本的浏览器以获得最佳体验。

获取帮助

如果以上问题无法解决您的问题，可以通过以下方式获取帮助：

• 📖 查看 完整文档
• 💬 在 GitHub Issues 提问
• 🔍 搜索已有的问题和解决方案