{"id":21597225,"url":"https://github.com/kkkgo/zerotier-planet-builder","last_synced_at":"2025-04-11T00:52:02.890Z","repository":{"id":65340041,"uuid":"526547607","full_name":"kkkgo/zerotier-planet-builder","owner":"kkkgo","description":"A ZeroTierOne planet with zero-ui web interface docker image builder.  ","archived":false,"fork":false,"pushed_at":"2024-03-06T07:17:42.000Z","size":120,"stargazers_count":55,"open_issues_count":3,"forks_count":117,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-11T00:51:57.873Z","etag":null,"topics":["docker","docker-image","zero-ui","zerotier","zerotier-one"],"latest_commit_sha":null,"homepage":"","language":"C++","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/kkkgo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2022-08-19T09:40:58.000Z","updated_at":"2025-04-02T00:41:28.000Z","dependencies_parsed_at":"2024-03-06T08:30:29.238Z","dependency_job_id":"62d91785-a28d-4f03-b02f-7a188d5f98c0","html_url":"https://github.com/kkkgo/zerotier-planet-builder","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkkgo%2Fzerotier-planet-builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkkgo%2Fzerotier-planet-builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkkgo%2Fzerotier-planet-builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkkgo%2Fzerotier-planet-builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kkkgo","download_url":"https://codeload.github.com/kkkgo/zerotier-planet-builder/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248322609,"owners_count":21084336,"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":["docker","docker-image","zero-ui","zerotier","zerotier-one"],"created_at":"2024-11-24T18:08:20.395Z","updated_at":"2025-04-11T00:52:02.853Z","avatar_url":"https://github.com/kkkgo.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zerotier-planet-builder\n[中文说明](#中文说明)  \nA ZeroTierOne planet with zero-ui web interface builder.  \nEasier, faster and smaller way to create your private zerotier controller container.  \nInspired by [docker-zerotier-planet](https://github.com/xubiaolin/docker-zerotier-planet)  and [zero-ui](https://github.com/dec0dOS/zero-ui).\n## How to use\n- 1 . Fork this repository.\n- 2 . Go to Setting - Secrets - Actions , add secrects:  \n\u003eIP : your planet server IP.  \nUSERNAME: zero-ui username.  \nPASSWORD: zero-ui password and docker image password.   \n\n![secrets.png](https://s2.loli.net/2022/08/29/uxcTpePls5SmbWn.png)\n- 3 . Go to Actions,click \"Run workflow.\"\n![run.png](https://s2.loli.net/2022/08/29/ITs4SVxLE9lORM3.png)\n- 4 . Wait 3 minutes and you will see the Artifacts below, download it.\n![artifacts.png](https://s2.loli.net/2022/08/29/Gc3fbyUwZReJOHt.png)\n- 5 . Use the password you set to unzip it to get **zerotier-planet.tar.gz** and upload it to your server.  \nPrepare the docker environment on your server and run the following command to import the image:\n```sh\ndocker image load \u003c zerotier-planet.tar.gz\n```\nCheck your image:\n```sh\ndocker images\n```\nRun docker:\n```sh\ndocker run -d --name zerotier-server -p 4000:4000 -p 9993:9993/udp  zerotier-planet\n```\nOr, if you want to mount the data to the host path\n```sh\ndocker run -d --name zerotier-server -p 4000:4000 -p 9993:9993/udp -v /data/zerotier:/var/lib/zerotier-one/controller.d -v /data/zero-ui/:/app/backend/data   zerotier-planet\n```\nNote that each run of the docker image produces a unique ID related file. If you create a new docker image, you need to copy the related files under/var/lib/zerotier-one under the original image.\n```sh\n docker cp zerotier-server:/var/lib/zerotier-one backup\n```\nOpen http://IP:4000, use your secrets USERNAME and PASSWORD to login.   \n## For client  \nReplace your planet file:  \nDownload your planet: http://IP:4000/app/planet  \n\nWindows: C:\\ProgramData\\ZeroTier\\One\\planet  \nLinux: /var/lib/zerotier-one/planet  \nMacos: /Library/Application\\ Support/ZeroTier/One/planet  \nAndriod: https://github.com/kaaass/ZerotierFix  \n\n**Note: Restart zerotier client related services after replacing the planet file.**\n\n# 中文说明\n一个zerotier planet docker生成器，轻松搭建属于你自己的zerotier服务器，目的是生成更简单，更快和更小的docker镜像。  \n本项目参考自 [docker-zerotier-planet](https://github.com/xubiaolin/docker-zerotier-planet)  和 [zero-ui](https://github.com/dec0dOS/zero-ui)，关于zerotier planet的概念和用途、客户端文件替换的配置，[docker-zerotier-planet](https://github.com/xubiaolin/docker-zerotier-planet)这个项目描述的很详细，本项目web端使用[zero-ui](https://github.com/dec0dOS/zero-ui)，更详尽的web端配置可以点进该项目查看进阶使用指南。  \n\n## 怎么使用\n- 1 . Fork 这个项目.\n- 2 . 点击你项目的 Setting - Secrets - Actions , 添加 secrects:  \n\u003eIP : 你的 planet 服务端 IP,就是公网IP  \nUSERNAME: 登陆zero-ui的用户名  \nPASSWORD: zero-ui 的密码，和docker的镜像压缩包密码.   \n\n![secrets.png](https://s2.loli.net/2022/08/29/uxcTpePls5SmbWn.png)\n- 3 . 点击 Actions,点击 \"Run workflow.\"\n![run.png](https://s2.loli.net/2022/08/29/ITs4SVxLE9lORM3.png)\n- 4 . 等待三分钟左右，就可以下载docker镜像了，大小在100M以内.\n![artifacts.png](https://s2.loli.net/2022/08/29/Gc3fbyUwZReJOHt.png)\n- 5 . 用你之前设置的密码解压文件得到 **zerotier-planet.tar.gz** 并上传到服务器.  \n在你的服务器准备docker运行环境，运行以下命令导入镜像:\n```sh\ndocker image load \u003c zerotier-planet.tar.gz\n```\n检查镜像是否导入成功:\n```sh\ndocker images\n```\n运行docker:\n```sh\ndocker run -d --name zerotier-server -p 4000:4000 -p 9993:9993/udp  zerotier-planet\n```\n或者，如果你想把数据挂在到主机目录，以便容器损坏的时候迁移：\n```sh\ndocker run -d --name zerotier-server -p 4000:4000 -p 9993:9993/udp -v /data/zerotier:/var/lib/zerotier-one/controller.d -v /data/zero-ui/:/app/backend/data   zerotier-planet\n```\n注意每次运行docker镜像生产唯一的id相关文件，如果你建立新docker镜像的话，你需要复制原来镜像下/var/lib/zerotier-one下的相关文件  \n```sh\n docker cp zerotier-server:/var/lib/zerotier-one backup\n```\n打开 http://IP:4000, 用你设置的secrets USERNAME 和 PASSWORD 登陆.  \n## 客户端\n替换planet文件:  \n下载planet: http://IP:4000/app/planet    \n\nWindows: C:\\ProgramData\\ZeroTier\\One\\planet    \nLinux: /var/lib/zerotier-one/planet    \nMacos: /Library/Application\\ Support/ZeroTier/One/planet    \nAndriod: https://github.com/kaaass/ZerotierFix    \n**注意替换planet文件后重启zerotier客户端相关服务.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkkkgo%2Fzerotier-planet-builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkkkgo%2Fzerotier-planet-builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkkkgo%2Fzerotier-planet-builder/lists"}