{"id":31468178,"url":"https://github.com/leeguooooo/swiftbar-warp-control","last_synced_at":"2026-04-20T19:31:59.865Z","repository":{"id":317303055,"uuid":"1066825507","full_name":"leeguooooo/swiftbar-warp-control","owner":"leeguooooo","description":"🚨 Fix Cloudflare WARP stuck on/force-enabled issue. Professional macOS menu bar tool for reliable WARP control when GUI fails. Password-free SwiftBar plugin.","archived":false,"fork":false,"pushed_at":"2025-09-30T04:02:55.000Z","size":108,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-14T17:52:54.867Z","etag":null,"topics":["automation","cloudflare-vpn","cloudflare-warp","command-line","force-disable","macos","macos-utility","menu-bar","plugin","security","swiftbar","troubleshooting","vpn","warp-cli","warp-control","warp-stuck"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leeguooooo.png","metadata":{"files":{"readme":"README-CN.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["leeguooooo"]}},"created_at":"2025-09-30T02:31:36.000Z","updated_at":"2025-09-30T04:03:15.000Z","dependencies_parsed_at":"2025-10-02T12:00:58.497Z","dependency_job_id":null,"html_url":"https://github.com/leeguooooo/swiftbar-warp-control","commit_stats":null,"previous_names":["leeguooooo/swiftbar-warp-control"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/leeguooooo/swiftbar-warp-control","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leeguooooo%2Fswiftbar-warp-control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leeguooooo%2Fswiftbar-warp-control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leeguooooo%2Fswiftbar-warp-control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leeguooooo%2Fswiftbar-warp-control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leeguooooo","download_url":"https://codeload.github.com/leeguooooo/swiftbar-warp-control/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leeguooooo%2Fswiftbar-warp-control/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32062317,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","cloudflare-vpn","cloudflare-warp","command-line","force-disable","macos","macos-utility","menu-bar","plugin","security","swiftbar","troubleshooting","vpn","warp-cli","warp-control","warp-stuck"],"created_at":"2025-10-01T19:55:12.478Z","updated_at":"2026-04-20T19:31:59.860Z","avatar_url":"https://github.com/leeguooooo.png","language":"Shell","funding_links":["https://github.com/sponsors/leeguooooo","https://ko-fi.com/leeguooooo"],"categories":[],"sub_categories":[],"readme":"# SwiftBar WARP Control\n\n**macOS 一键无密码控制 Cloudflare WARP**\n\n专业、安全、高效的工具，通过 SwiftBar 将 Cloudflare WARP 控制集成到您的 macOS 菜单栏，消除重复的密码输入。\n\n![License](https://img.shields.io/badge/license-MIT-blue.svg)\n![macOS](https://img.shields.io/badge/macOS-10.15+-brightgreen.svg)\n![SwiftBar](https://img.shields.io/badge/SwiftBar-2.0+-orange.svg)\n![GitHub release](https://img.shields.io/github/v/release/leeguooooo/swiftbar-warp-control)\n![GitHub stars](https://img.shields.io/github/stars/leeguooooo/swiftbar-warp-control)\n\n[English](README.md) | 简体中文\n\n## 功能特性\n\n- **无密码控制**: 开关 WARP 无需重复输入密码\n- **一键安装**: 自动安装所有依赖，包括 SwiftBar\n- **安全设计**: 最小权限提升，仅用于 WARP 控制命令\n- **简洁界面**: 无缝菜单栏集成和状态指示器\n- **智能检测**: 自动检测 WARP 状态和系统要求\n- **丰富菜单**: 启动、停止、重启和状态检查选项\n- **轻松卸载**: 包含完整卸载脚本\n\n## 截图预览\n\n![Demo](demo.png)\n\n### 菜单栏集成\n```\n🟢 WARP  (连接时)\n🔴 WARP  (断开时)\n```\n\n### 菜单选项\n- **状态**: 已连接/已断开，带颜色指示器\n- **控制**: 启动、停止、重启 WARP\n- **工具**: 查看状态、打开 WARP 应用\n- **链接**: 项目主页和文档\n\n## 系统要求\n\n- **macOS**: 10.15 (Catalina) 或更高版本\n- **Cloudflare WARP**: 需要从 App Store 或官网安装\n- **管理员权限**: 仅首次设置时需要\n\n## 安装方式\n\n在终端中运行此命令：\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/leeguooooo/swiftbar-warp-control/main/install.sh | bash\n```\n\n或手动克隆安装：\n\n```bash\ngit clone https://github.com/leeguooooo/swiftbar-warp-control.git\ncd swiftbar-warp-control\nbash install.sh\n```\n\n## 安装内容\n\n安装程序会自动处理：\n\n1. **Homebrew** (如果尚未安装)\n2. **SwiftBar** (如果尚未安装)\n3. **WARP 控制脚本** (`/usr/local/bin/warp-control.sh`)\n4. **Sudo 配置** (`/etc/sudoers.d/warp-toggle`)\n5. **SwiftBar 插件** (`~/swiftbar/warp.5s.sh`)\n6. **SwiftBar 配置** (自动设置插件目录)\n\n## 安全性\n\n本工具以安全为重点设计：\n\n- **最小权限**: 仅允许无密码执行特定的 WARP 控制脚本\n- **用户特定**: 权限仅授予安装用户\n- **隔离命令**: 无法访问其他系统命令或 sudo 操作\n- **开源透明**: 完整代码透明，可进行安全审查\n\nsudo 配置仅允许：\n```bash\nusername ALL=(ALL) NOPASSWD: /usr/local/bin/warp-control.sh\n```\n\n## 使用方法\n\n安装后，WARP 控制图标将自动出现在您的菜单栏中。**无需手动配置** - 安装程序会自动为 SwiftBar 设置正确的插件目录。\n\n### 状态指示器\n- **🟢 WARP**: 已连接并运行\n- **🔴 WARP**: 已断开或停止\n\n### 菜单操作\n- **启动 WARP**: 连接到 Cloudflare WARP\n- **停止 WARP**: 断开 WARP 连接\n- **重启 WARP**: 重启 WARP 连接\n- **查看状态**: 在终端中查看详细连接状态\n- **打开 WARP 应用**: 启动官方 WARP 应用程序\n\n### 命令行使用\n\n您也可以直接从终端控制 WARP：\n\n```bash\n# 启动 WARP\nsudo /usr/local/bin/warp-control.sh start\n\n# 停止 WARP\nsudo /usr/local/bin/warp-control.sh stop\n\n# 检查状态\nsudo /usr/local/bin/warp-control.sh status\n\n# 切换开/关\nsudo /usr/local/bin/warp-control.sh toggle\n```\n\n## 卸载\n\n完全删除所有组件：\n\n```bash\nbash uninstall.sh\n```\n\n这将删除：\n- WARP 控制脚本\n- Sudo 配置\n- SwiftBar 插件\n\n*注意：SwiftBar 和 Cloudflare WARP 应用程序不会被自动删除。*\n\n## 手动卸载\n\n如果需要手动删除组件：\n\n```bash\n# 删除 WARP 控制脚本\nsudo rm -f /usr/local/bin/warp-control.sh\n\n# 删除 sudo 配置\nsudo rm -f /etc/sudoers.d/warp-toggle\n\n# 删除 SwiftBar 插件\nrm -f ~/swiftbar/warp.5s.sh\n```\n\n## 故障排除\n\n### WARP 无法启动/停止\n1. 确保 Cloudflare WARP 已安装并正常工作\n2. 尝试手动运行控制脚本：\n   ```bash\n   sudo /usr/local/bin/warp-control.sh status\n   ```\n\n### 菜单栏图标未出现\n1. 检查 SwiftBar 是否正在运行\n2. 在 SwiftBar 首选项中验证插件目录\n3. 刷新 SwiftBar 插件\n\n### 权限被拒绝错误\n1. 验证 sudoers 配置：\n   ```bash\n   sudo visudo -c -f /etc/sudoers.d/warp-toggle\n   ```\n2. 尝试注销并重新登录\n3. 使用安装脚本重新安装\n\n### SwiftBar 插件显示错误\n1. 检查控制脚本是否存在：\n   ```bash\n   ls -la /usr/local/bin/warp-control.sh\n   ```\n2. 验证脚本权限：\n   ```bash\n   sudo chmod 755 /usr/local/bin/warp-control.sh\n   ```\n\n更多帮助，请参阅 [故障排除指南](docs/TROUBLESHOOTING.md)\n\n## 更新\n\n更新到最新版本：\n\n```bash\n# 拉取最新更改\ngit pull origin main\n\n# 重新安装\nbash install.sh\n```\n\n## 贡献\n\n欢迎贡献！请先阅读我们的 [贡献指南](CONTRIBUTING.md)。\n\n### 开发设置\n\n```bash\n# 克隆仓库\ngit clone https://github.com/leeguooooo/swiftbar-warp-control.git\ncd swiftbar-warp-control\n\n# 在开发模式下测试安装\nbash install.sh\n```\n\n### 提交更改\n\n1. Fork 仓库\n2. 创建功能分支\n3. 进行更改\n4. 彻底测试\n5. 提交拉取请求\n\n## 许可证\n\n本项目基于 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。\n\n## 致谢\n\n- **[SwiftBar](https://github.com/swiftbar/SwiftBar)**: 强大的 macOS 菜单栏自定义工具\n- **[Cloudflare WARP](https://1.1.1.1/)**: 快速、安全、私密的互联网连接\n- **[BitBar](https://github.com/matryer/bitbar)**: 菜单栏插件的原始灵感来源\n\n## 支持\n\n- **错误报告**: [GitHub Issues](https://github.com/leeguooooo/swiftbar-warp-control/issues)\n- **功能请求**: [GitHub Discussions](https://github.com/leeguooooo/swiftbar-warp-control/discussions)\n- **文档**: [Wiki](https://github.com/leeguooooo/swiftbar-warp-control/wiki)\n\n## 赞助支持\n\n如果这个项目对您有帮助，请考虑支持项目的发展：\n\n[![GitHub Sponsors](https://img.shields.io/badge/sponsor-GitHub%20Sponsors-ff69b4.svg)](https://github.com/sponsors/leeguooooo)\n[![Ko-fi](https://img.shields.io/badge/Ko--fi-F16061?style=flat\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/leeguooooo)\n\n您的赞助帮助维护和改进这个项目。感谢您的支持！\n\n### 特别感谢我们的赞助者\n\n*赞助者将在此列出。成为第一个支持此项目的人！*\n\n## Star 历史\n\n如果这个项目对您有帮助，请考虑给它一个 star！\n\n[![Star History Chart](https://api.star-history.com/svg?repos=leeguooooo/swiftbar-warp-control\u0026type=Date)](https://star-history.com/#leeguooooo/swiftbar-warp-control\u0026Date)\n\n---\n\n**为 macOS 社区精心制作**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleeguooooo%2Fswiftbar-warp-control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleeguooooo%2Fswiftbar-warp-control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleeguooooo%2Fswiftbar-warp-control/lists"}