{"id":26621588,"url":"https://github.com/zhitrend/zhitrend_cpolar","last_synced_at":"2025-10-26T05:39:56.873Z","repository":{"id":268189322,"uuid":"903584148","full_name":"zhitrend/zhitrend_cpolar","owner":"zhitrend","description":"与cpolar功能类似的内网穿透方案。免费版，可自定义域名","archived":false,"fork":false,"pushed_at":"2024-12-15T02:57:28.000Z","size":41,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-27T08:15:45.031Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhitrend.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-15T01:28:28.000Z","updated_at":"2024-12-15T02:57:32.000Z","dependencies_parsed_at":"2024-12-15T03:16:39.885Z","dependency_job_id":"df376d8b-77fb-40e2-a919-f0bf8b9d5bf5","html_url":"https://github.com/zhitrend/zhitrend_cpolar","commit_stats":null,"previous_names":["zhangrongwu/zhitrend_cpolar","zhitrend/zhitrend_cpolar"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhitrend%2Fzhitrend_cpolar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhitrend%2Fzhitrend_cpolar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhitrend%2Fzhitrend_cpolar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhitrend%2Fzhitrend_cpolar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhitrend","download_url":"https://codeload.github.com/zhitrend/zhitrend_cpolar/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245240835,"owners_count":20583102,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2025-03-24T09:17:26.872Z","updated_at":"2025-10-26T05:39:51.839Z","avatar_url":"https://github.com/zhitrend.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 内网穿透管理系统\n\n一个基于 FastAPI 的内网穿透管理系统，支持用户认证、隧道管理等功能。\n\n## 功能特性\n\n- 用户认证（JWT）\n- 隧道管理\n- 实时监控\n- 自定义域名支持\n\n## 系统要求\n\n- Python 3.7+\n- pip（Python 包管理器）\n- 现代浏览器（支持 ES6+）\n\n## 安装部署\n\n1. 克隆项目：\n```bash\ngit clone [项目地址]\ncd zhitrend_cpolar\n```\n\n2. 安装依赖：\n```bash\npip install -r requirements.txt\n```\n\n3. 配置环境变量：\n创建 `.env` 文件并设置以下变量：\n```\nSERVER_HOST=0.0.0.0\nSERVER_PORT=8080\nJWT_SECRET=your_jwt_secret_key\nSERVER_URL=ws://localhost:8080\nLOCAL_PORT=8000\nPUBLIC_PORT=8888\n```\n\n4. 启动服务：\n```bash\nuvicorn server:app --host 0.0.0.0 --port 8080 --reload\n```\n\n## 验证指南\n\n### 1. 用户注册和登录\n\n1. 访问 http://localhost:8080/admin\n2. 点击\"注册\"，填写用户信息\n3. 使用注册的账号登录系统\n\n### 2. 创建隧道\n\n1. 登录后，在管理界面填写隧道信息：\n   - 本地端口：要暴露的本地服务端口（如 8000）\n   - 公网端口：外部访问端口（如 8888）\n   - 自定义域名：（可选）\n\n2. 点击\"创建隧道\"按钮\n\n### 3. 验证隧道\n\n1. **本地服务验证**：\n   ```bash\n   # 启动一个测试服务在本地端口\n   python -m http.server 8000\n   ```\n\n2. **隧道连接验证**：\n   - 通过公网端口访问：http://localhost:8888\n   - 如果配置了自定义域名：http://your-domain:8888\n\n3. **检查连接状态**：\n   - 在管理界面查看隧道状态\n   - 检查服务器日志：`tail -f server.log`\n\n### 4. 常见问题排查\n\n1. **端口被占用**：\n   ```bash\n   # 检查端口占用\n   lsof -i :8000\n   lsof -i :8888\n   ```\n\n2. **连接失败**：\n   - 检查防火墙设置\n   - 确认本地服务是否正常运行\n   - 查看服务器日志中的错误信息\n\n## API 文档\n\n### 认证接口\n\n- POST `/api/register` - 用户注册\n- POST `/api/login` - 用户登录\n\n### 隧道管理\n\n- GET `/api/tunnels` - 获取隧道列表\n- POST `/api/tunnels` - 创建新隧道\n- DELETE `/api/tunnels/{client_id}` - 删除隧道\n\n## 安全建议\n\n1. 修改默认的 JWT 密钥\n2. 使用强密码\n3. 定期更新系统和依赖\n4. 限制可用端口范围\n5. 启用 HTTPS\n\n## 监控和维护\n\n1. **日志监控**：\n```bash\ntail -f server.log\n```\n\n2. **系统状态**：\n- 访问管理界面查看实时状态\n- 检查资源使用情况\n\n3. **备份**：\n定期备份用户数据和配置文件：\n```bash\ncp users.json users.json.backup\ncp .env .env.backup\n```\n\n## 贡献指南\n\n1. Fork 项目\n2. 创建功能分支\n3. 提交更改\n4. 发起 Pull Request\n\n## 许可证\n\n[许可证类型]\n\n## 联系方式\n\n[联系信息]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhitrend%2Fzhitrend_cpolar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhitrend%2Fzhitrend_cpolar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhitrend%2Fzhitrend_cpolar/lists"}