{"id":13468453,"url":"https://github.com/MirageNetwork/MirageServer","last_synced_at":"2025-03-26T05:31:07.203Z","repository":{"id":188164920,"uuid":"601938445","full_name":"MirageNetwork/MirageServer","owner":"MirageNetwork","description":"蜃境：基于Headscale修改的带WebUI开源版本Tailscale控制器","archived":false,"fork":false,"pushed_at":"2024-01-23T04:43:14.000Z","size":25450,"stargazers_count":189,"open_issues_count":13,"forks_count":18,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-10-29T22:56:28.076Z","etag":null,"topics":["headscale","mirage","sdp","tailscale","web-ui","zero-trust"],"latest_commit_sha":null,"homepage":"https://www.gps.moe","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MirageNetwork.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"ko_fi":"gps949"}},"created_at":"2023-02-15T06:31:13.000Z","updated_at":"2024-10-26T17:06:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"e5bcadd3-7afb-47d5-8fb8-dd7f30fd083d","html_url":"https://github.com/MirageNetwork/MirageServer","commit_stats":null,"previous_names":["miragenetwork/mirageserver"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MirageNetwork%2FMirageServer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MirageNetwork%2FMirageServer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MirageNetwork%2FMirageServer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MirageNetwork%2FMirageServer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MirageNetwork","download_url":"https://codeload.github.com/MirageNetwork/MirageServer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245597232,"owners_count":20641859,"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":["headscale","mirage","sdp","tailscale","web-ui","zero-trust"],"created_at":"2024-07-31T15:01:11.118Z","updated_at":"2025-03-26T05:31:06.191Z","avatar_url":"https://github.com/MirageNetwork.png","language":"Vue","funding_links":["https://ko-fi.com/gps949"],"categories":["Vue"],"sub_categories":[],"readme":"\u003cimg src=\"https://user-images.githubusercontent.com/7601383/219330724-55bc04e5-3f19-433b-98fe-6d19333af8b5.png\" width=\"60%\" height=\"60%\"\u003e  \n\n\n基于Headscale实现的具有WebUI的Tailscale控制服务器       \n    \n**注意** 此版本可能与Headscale、Tailscale官方版本均有不兼容的情况，如需与官方版本并用需要考虑进行兼容性测试。    \n      \n      \n# 使用方法    \n   \n**免配启动**    \n编译后，直接运行程序即可   \n* 默认超管控制台监听:```8081端口```，如需避免冲突进行修改只需运行前配置环境变量，例如 ```export MIRAGE_SYS_ADDR=\"127.0.0.1:18081\"```   \n* 首次启动因为没有适当配置，控制器服务不会启动，需登录超管控制台（即通过前述的端口的```/cockpit```路径）绑定超级管理员（使用WebAuthn方式，建议使用苹果设备或yubikey，现代浏览器的密钥管理系统应该能支持但是并不建议）    \n* 要使控制器能启动的基本配置需要在cockpit上配置服务域名，要具备实际使用价值则需要再多配置任一种或几种支持的第三方身份服务商    \n* 最新版本已经弃用了原本的URL读取外部DERP列表的方式，为了连通性可用性，建议在正式用户/租户登入前配置至少一条司南信息\n    \n     \n# 完成功能进度(ToDo List)：    \n- [x] 系统零配置文件启动，页面初始化功能   \n- [x] 超管驾驶舱   \n    - [x] 超管绑定/登录/登出     \n    - [x] 系统运行状态展示与控制    \n    - [x] 配置页   \n        - [x] 系统基本配置   \n        - [x] 三方服务配置【后续需要进行调整】   \n        - [x] 超管换绑      \n        - [x] 客户端版本发布      \n    - [x] 租户页   \n        - [x] 租户列表展示   \n        - [x] 删除租户   \n        - [x] 编辑租户(owner、provider、名称、magicDomain)       \n        - [x] 租户用量信息   \n    - [x] DERP页   \n        - [x] 全局DERP服务配置  \n        - [x] DERP服务自动化部署   \n        - [ ] DERP详情页 \n    - [ ] 用户页?   \n        - [ ] 个人租户信息展示与管理？  \n    - [x] 系统日志页   \n- [x] 注册与登录   \n    - [x] Google、Microsoft、GitHub、Apple账号登录\n    - [x] ~~OIDC对接阿里云IDaaS登录【暂时弃用】~~   \n    - [x] ~~对接阿里云手机号注册【暂时弃用】~~   \n    - [ ] 个人微信/QQ/微博登录   \n    - [ ] 企业微信/钉钉对接登录    \n- [x] 主界面框架与页头部用户基本信息展示、登出     \n- [x] 设备页签      \n    - [x] 设备列表信息展示      \n    - [x] 单个设备详情页展示      \n    - [x] 设备IP复制与设备控制菜单展示      \n    - [x] 修改设备名      \n    - [x] 启/停用设备密钥过期      \n    - [x] 编辑设备子网路由    \n    - [x] 删除设备      \n    - [x] 编辑设备ACL标签        \n    - [x] 客户端版本更新提示   \n    - [ ] 分享设备\n- [ ] 服务页签【暂不考虑】    \n- [x] 用户页签   \n    - [x] 用户列表展示   \n    - [x] 管理员身份转移/添加\n    - [ ] 更多种类角色划分编辑\n    - [ ] 用户设备筛查\n    - [ ] 用户冻结\n- [x] ACL页签      \n    - [x] 标签管理    \n    - [ ] 群组管理\n    - [ ] 别名管理？\n    - [ ] ACL规则条目编辑    \n- [x] DNS页签      \n    - [x] 基本信息展示      \n    - [x] 启/停用MagicDNS     \n    - [x] 启/停用Override Local    \n    - [x] 添加全球域名服务器   \n    - [x] 添加split域名服务器   \n    - [x] 修改/删除域名服务器   \n    - [x] Basedomain解绑用户名以及可修改   \n    - [x] Split域名服务器可调整顺序   \n    - [ ] ~~DNS厂商预植【暂不考虑】~~   \n    - [ ] ~~HTTPS证书（BETA）【暂不考虑】~~    \n    - [ ] ~~NextDNS支持【暂不考虑】~~    \n- [x] DERP页签\n    - [x] 组织DERP列表展示\n    - [x] 组织DERP列表基本操作接口\n    - [x] 全局DERP的区别展示\n    - [x] 全局DERP区域的禁用操作\n- [x] 设置页签       \n    - [x] 通用设置 （暂时不处理设备需预授权开关）\n        - [x] 组织名称\n        - [x] 身份提供商\n        - [x] 设备默认秘钥过期时长     \n    - [x] 账单及用量显示   \n    - [x] 密钥管理   \n        - [x] 授权密钥管理【需要考量这个与用户绑定关系】    \n        - [ ] ~~API密钥管理【暂不考虑】~~     \n    - [ ] 特性功能开关    \n    - [ ] ~~webhook【暂不考虑】~~  \n    - [ ] ~~OAuth Client【暂不考虑】~~    \n- [x] 组织切分及身份源管理   \n    - [x] 按组织划分最终用户    \n    - [x] 组织管理员配置   \n    - [x] DNS、ACL及其他有关系统配置归属至组织   \n- [ ] ~~日志页签【暂不考虑】~~    \n- [ ] ~~i18n【暂不考虑】~~   \n- [ ] ~~前后端分离【是否有必要？】【暂不考虑】~~      \n    \n  \n# 截图    \n    \n## 超管界面    \n    \n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/226161921-0df684fa-4956-4681-b5d1-119e5f434246.png\" width=\"50%\" height=\"50%\"\u003e\n    \n    \n## 管理员（当前是用户）界面    \n       \n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/218957899-89ba2492-8508-40aa-b6c7-92d57ecde6d5.png\" width=\"80%\" height=\"80%\"\u003e   \n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/218959833-b2e70903-5250-4fd1-b175-a6b29aef9199.png\" width=\"80%\" height=\"80%\"\u003e    \n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/218959838-2fc1ba9d-b372-4890-806e-28a0ce5c4928.png\" width=\"80%\" height=\"80%\"\u003e    \n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/218959854-b3d02123-b917-4f06-a8cb-a619f591cd42.png\" width=\"80%\" height=\"80%\"\u003e    \n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/218959858-83f4f57e-dfa6-4886-bd1d-e608b8e7b27c.png\" width=\"80%\" height=\"80%\"\u003e    \n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/218959865-35cc93ea-953a-451e-881c-8b216518971d.png\" width=\"80%\" height=\"80%\"\u003e    \n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/218959876-32b0c444-8be4-4372-89f8-05a50c9f775c.png\" width=\"80%\" height=\"80%\"\u003e    \n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/226161978-04a80f9a-5a79-4a09-823a-e76d921cd629.png\" width=\"50%\" height=\"50%\"\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/226162115-2aa9aad3-48aa-4a86-8608-4d82058f07fa.png\" width=\"50%\" height=\"50%\"\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/226162138-7a5f2d4b-f699-40da-a2a2-7cd7f9dd8c39.png\" width=\"50%\" height=\"50%\"\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/218959888-36064015-1052-454b-a5ad-854ceaabe363.png\" width=\"80%\" height=\"80%\"\u003e    \n\u003cimg src=\"https://user-images.githubusercontent.com/7601383/218959893-8c398c91-bddc-4176-836f-ebc6806567b0.png\" width=\"80%\" height=\"80%\"\u003e    \n    \n\n      \n感谢Tailscale、Headscale及开源社区的共同努力。    \n      \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMirageNetwork%2FMirageServer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMirageNetwork%2FMirageServer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMirageNetwork%2FMirageServer/lists"}