Repository navigation
Releases: vioIetMiku/miku-gate
Release list
Miku Gate v0.2.6
Miku Gate v0.2.6 — 前后端分离与自动端口
Docker 默认两个独立 Compose 项目：非特权 Nginx 静态前端，以及负责认证 / API / VPN 的 Go 后端。原生和仅后端继续兼容内嵌页面。
bash <(curl -fsSL https://raw.githubusercontent.com/vioIetMiku/miku-gate/main/mikugate.sh) --docker准备 Linux Docker/Compose、Python 3.10+ 和 TUN；部署后用 sudo bash install-docker.sh frontend info 读取真实前端完整地址，并用后端口令登录。
- 两端端口占用自动避让，默认优先后端8899 / 前端8900，读取真实保存结果，不猜地址。
- frontend start/restart/stop/info/check 独立维护，停前端不停止后端；顶层 stop/down 操作两端。
- 同源登录/API/订阅代理，随机路径与 Origin 保护；远程 HTTPS 后端验证证书。
- 前端专用包可部署到另一台 Linux 服务器，无需后端 TUN、Go、程序或私钥。
- 保留缓存优化和 quick/sub；二进制全部从源码重建为 0.2.6。
附件为 miku、完整 VPS 包、完整源码 ZIP、前端专用包、install-online.sh、SHA256SUMS，共六项。
详细安装、跨服务器、HTTPS、端口和升级说明见 README 与 docs/FRONTEND.md。旧原生维护工具有文件数限制，升级推荐解压新包后 install.sh --update；Docker 先备份再更新原项目目录，保留数据与 .env。旧标签和附件不覆盖。
后端仍需特权、host网络和TUN；前端权限不同。Docker 不运行原生 systemd 续期 timer，前端公网 TLS 由外层反代维护。真实隧道/公网证书由部署者验收。
Miku Gate v0.2.5
Miku Gate v0.2.5 — Docker 部署支持
保留 v0.2.4 的连接稳定性与全部 Go 应用功能，新增 Linux Docker / Compose 部署。
安装
# Linux VPS root Bash；先准备 Docker Engine、Compose v2 和 TUN
bash <(curl -fsSL https://raw.githubusercontent.com/vioIetMiku/miku-gate/main/mikugate.sh) --dockerDocker 项目保存在 /opt/miku-gate-docker，本机构建镜像后后台运行。也可下载校验完整 VPS 包后 sudo bash install.sh --docker；Git 源码可通过 sudo bash install-docker.sh up 源码构建。未发布 GHCR / Docker Hub 预制项目镜像。
关键限制
- 需要 rootful Linux Docker、
network_mode: host、privileged: true、/dev/net/tun；容器可影响宿主网络，不适用于 rootless 或 Desktop。 - 不得与同机原生 Miku 服务混跑，不直接复用原生数据目录。已有原生安装可继续使用原流程升级。
- 凭据、节点、核心与证书保存在项目目录的数据卷中；
backup停机一致性备份，down保留数据。 - 升级需下载新文件后
bash install-docker.sh update；原生miku update不用于容器。 - Docker 暂无后台自动续证，需网页重新签发或宿主机续期后在网页应用。
附件仍为独立 miku、miku-gate-vps-v0.2.5.tar.gz、miku-gate-v0.2.5.zip、install-online.sh 和 SHA256SUMS。完整流程见 Docker 指南。
发布前验证原生测试、Docker 离线回归、Go 竞态/vet、DOM、双架构源码构建、镜像启动与重建保留数据、备份恢复，以及附件 SHA256 / BUILD 清单与自解压校验。真实 VPN Gate 连接与证书签发仍需部署者验收。
Miku Gate v0.2.4
Miku Gate v0.2.4 正式版
基于 miku-gate-v0.2.4.zip，继续使用 Miku Gate / miku-gate。
主要更新
- 普通新建与快速连接按目标数量的 3 倍竞发，成功节点立即显示，达标后取消多余候选。
- 普通任务支持停止补齐和全部停止，候选不进入订阅、展示或恢复状态。
- OpenVPN 保活与连接重试参数集中管理，过滤冲突配置；软恢复保留 TUN 与密钥。
- 健康检查连续 3 次且持续 75 秒才重建，明确身份错误仍立即处理；新增 IP 来源回退。
- 继续提供
miku独立安装文件、mikugate.sh短入口、miku quick和多格式订阅。
升级
miku backup
miku update /root/miku-gate-vps-v0.2.4.tar.gz公开短入口保持：
bash <(curl -fsSL https://raw.githubusercontent.com/vioIetMiku/miku-gate/main/mikugate.sh)公共 VPN Gate 节点的在线、速度和出口属性仍取决于志愿者节点及部署环境。
Miku Gate v0.2.3
Miku Gate v0.2.3 正式版
基于 dev41，包含 dev37—dev41 的更新，继续使用 Miku Gate / miku-gate。
更新重点
- 独立自解压安装文件
miku，无需 Go：sudo bash miku。支持选择终端一键搭建或网页面板。 miku quick后台持续准备日本 5、韩国 3、美国 3 个就绪节点，最多 33 个并发候选，失败滚动替换并刷新来源；miku sub输出五种订阅及可用节点。- 终端静默等待，Ctrl+C 输出已有结果并保留后台补齐；来源、核心、证书并行准备，管理页面启动不再等待慢来源。
- 一键节点域名更换或切回 REALITY 时复用端口与凭据；未就绪候选不进入订阅或重启恢复。
- 新版欢迎区、实时统计、IP 详情、白天/夜间主题与内置国旗；桌面双列、620px 以下单列，任务展开状态保留，默认近期实测延迟排序。
附件
- miku：自解压安装文件，含 amd64 / arm64 程序，
bash miku --verify只校验。 - miku-gate-vps-v0.2.3.tar.gz：通用 VPS 包。
- miku-gate-v0.2.3.zip：完整源码及双架构程序。
- install-online.sh：在线一键安装脚本。
- SHA256SUMS：上述四个附件校验。
# 已有安装：先备份，校验新包后更新
miku backup
miku update /root/miku-gate-vps-v0.2.3.tar.gz
# 之后按需启动一键配置
miku quickmiku 命令、服务名与数据目录保持兼容。节点域名与管理域名分开；不带域名使用 REALITY。33 是候选并发上限，不是成功节点数量。公共节点不足时后台持续等待，服务进程重启后需重新运行 quick 继续补齐。
本次发布要求 Go 竞态/vet、安装器与终端回归、页面 DOM 交互、双架构源码构建、自解压校验及上传后 SHA256 回验全部通过。实际 VPS 的 OpenVPN、证书签发与客户端连通需部署者验收。
感谢 VPN Gate 志愿者及 byJoey/fanout；MIT 署名与新增国旗许可证均保留。
Miku Gate v0.2.2
Miku Gate v0.2.2 正式版
基于 dev36 更新，项目与发布包继续统一为 Miku Gate / miku-gate。
更新内容
- 修复管理域名切换时同端口监听可能关闭的问题，加入旧页面地址交接、轮询暂停和随机路径保护。
- 兼容反向代理 HTTPS 来源，正确设置 Secure Cookie 与 Origin 校验。
- 证书来源探测缓存、手动刷新、Certbot 无邮箱签发、域名末尾点规范化和旧 API 参数兼容。
- 管理监听器临时 Accept 错误恢复、协议探测与空闲客户端处理。
- 协议标签缩小，完整配置提示保留。
附件
miku-gate-vps-v0.2.2.tar.gz：amd64 / arm64 通用 VPS 安装包。miku-gate-v0.2.2.zip：完整源码与双架构安装程序。install-online.sh：VPS 一键安装脚本。SHA256SUMS：附件校验清单。
升级前建议执行 miku backup，然后运行 miku update /root/miku-gate-vps-v0.2.2.tar.gz。发布流程要求测试、竞态检查、双架构构建及上传后 SHA256 回验全部通过，才转为正式 Release。
Miku Gate v0.2.1
Miku Gate v0.2.1 正式版
基于 dev35 更新，项目与发布包继续统一为 Miku Gate / miku-gate。保留 VPN Gate 介绍、byJoey/fanout 致谢、MIT 许可证及原作者署名。
更新内容
- 源码、测试和内嵌素材迁入
src/。 - 实际入口协议栈显示（传输、安全层和 VISION）。
- 证书复用及有效性检查、Webroot 签发、域名完整登录地址和外部续期来源。
- IPv4 / IPv6 端口检查，避让已有面板与入口；就绪检查核对本服务响应标识。
- 完整卸载菜单，保留停止服务但不删数据的原模式。
附件
miku-gate-vps-v0.2.1.tar.gz：amd64 / arm64 通用 VPS 安装包。miku-gate-v0.2.1.zip：完整源码与双架构安装程序。install-online.sh：VPS 一键脚本，默认下载最新正式版。SHA256SUMS：附件校验清单。
本版包内根目录为 miku-gate/，手动安装使用 sudo bash miku-gate/install.sh。现有 miku 命令、服务名、/var/lib/miku 和 /usr/local/lib/miku 路径不变。
升级
miku backup
miku update /root/miku-gate-vps-v0.2.1.tar.gz请先按 SHA256SUMS 校验下载包，或使用 README 一键安装。miku uninstall 保留数据；miku uninstall --purge 会删除本服务数据和备份，执行前务必将备份保存到服务目录之外。
发布流程要求 Go 竞态检查、vet、安装器回归、双架构源码重建及上传后回验全部通过，才转为正式 Release。真实 VPS 上的 VPN Gate 连通、证书签发和客户端兼容仍需部署者验收。
Miku Gate v0.2.0
Miku Gate v0.2.0 正式版
基于 dev34，将 VPN Gate OpenVPN 出口、自建 Xray / sing-box、已有面板适配、认证代理与多格式订阅整合到 Miku 单页控制台。包含白天 / 夜间主题、移动布局、展示模式、同国家重连、IP 信息和稳定性提示。
首先感谢 VPN Gate 学术实验及志愿者提供公共节点，也特别感谢 byJoey/fanout 的开源基础。原 MIT 许可证与署名完整保留。
下载
- miku-gate-vps-v0.2.0.tar.gz：Linux VPS 通用安装包，包含 amd64 / arm64 的主程序与兼容导出程序。
- miku-gate-v0.2.0.zip：完整源码及两种架构安装二进制。
- install-online.sh：VPS 一键安装脚本，默认选择最新正式版；支持私有仓库 GITHUB_TOKEN。
- SHA256SUMS：上述三个文件的完整性校验。
包内目录保留 miku-fanout/ 以兼容现有安装流程。所有二进制从对应提交的源码重新构建，内置版本为 0.2.0，不复用 dev34 的预编译文件。
安装与更新
请阅读 README 的 VPS 一键安装，尤其是私有仓库的令牌安装方式。手动安装：
grep ' miku-gate-vps-v0.2.0.tar.gz$' SHA256SUMS | sha256sum -c -
sudo tar --no-same-owner -xzf miku-gate-vps-v0.2.0.tar.gz
sudo bash miku-fanout/install.sh已有安装先运行 miku backup，再使用新包的安装器或 miku update /绝对路径/安装包.tar.gz。安装要求 root、TUN、netns、iptables，以及 systemd / OpenRC；VPS 不需要安装 Go。
注意
旧架构的任务、远程 Agent、多账号及高级记录不会完整迁移，升级前必须备份。VPN Gate 节点由志愿者运营，不保证在线、住宅属性、固定 IP 或严格隐私；实际 VPS 的网络、面板、证书和客户端连接仍需要部署者验收。
发布流程要求离线 Go 测试 / vet、安装器回归、两种架构源码构建、压缩包与版本验证及上传后 SHA256 校验全部通过，才从草稿转为正式 Release。
Miku Gate v0.1.0-dev.15 — 官方3x-ui持久复用与本机HTTPS预览
Miku Gate v0.1.0-dev.15 · 官方面板持久复用与可信HTTPS
固定源362daa7。真实官方3x-ui v3.9.0的普通UID/匿名回环专项38126941080成功：实际登录/CSRF、持久模板保存、原UUID与其他节点保留、TLS/Vision客户端到Miku认证代理、面板进程重启仍保留路由和业务、代理停止无direct后备、原模板节点回滚。首次统计规则规范化失败保留；精确修正唯一api规则，不忽略其他差异。
本机面板支持HTTPS-only与明确SAN域名，仍只数字拨号127.0.0.1；系统CA/TLS验证，未受信任时不发送登录口令、不提供insecure。
核对SHA256SUMS，Linux包解压到root受保护目录后执行 sudo sh scripts/install-vps.sh；缺依赖/IP或域名/端口/已有工具意图/核心/证书/最终应用逐项确认。内嵌界面无需Go/Node，原面板/路由/防火墙不自动改。已安装用配套升级，不用首次安装覆盖数据；schema7只允许完整旧程序/DB/key/证书快照回滚。
保留dev.14自动恢复/同国家候选/持久暂停、双核心TLS/REALITY/Trojan、证书身份更新、IP归属/ASN/DNSBL、加密备份/升级回滚与保留数据服务卸载。Windows仅控制/代理配置预览，Linux隔离/systemd不套用Windows。
三平台压缩包和校验值不覆盖旧发行。当前官方实测只v3.9.0、受控回环业务，不等于用户VPS公网到真实VPN。其他面板/独立旧核心兼容、root实际ACME、installed长稳与真实自动换线、最终公网部署/跨机恢复仍待完成，整个目标和Issue开放。
Miku Gate v0.1.0-dev.14 — 自动恢复与同国家候选换线预览
Miku Gate v0.1.0-dev.14 · 自动恢复与同国家候选换线预览
固定源205f67408418ee5f3fc597c0d392fe120d71de6d。新增明确授权的自动恢复、同国家最多3个VPN备用与持久暂停；安装运维验收进一步覆盖保留数据的服务卸载/恢复注册。仍为预览，不把受控验收当所有公网/官方面板版本已完成。
安装
核对SHA256SUMS，Linux amd64/arm64包解压到root受保护目录：
sudo sh scripts/install-vps.sh --plan-only
sudo sh scripts/install-vps.sh先检测缺依赖/确认安装，再域名或IP、管理端口、已有工具意图、受管核心/证书/最终apply确认。内嵌界面，无需Go/Node；原有面板/宿主路由/防火墙不改，80/443冲突不抢。IP自签引导需核对/导入信任。已安装Miku使用配套备份升级入口，不用首次安装器覆盖。schema7配套DB/key/程序旧快照才可回滚，不单独换旧程序。
自动恢复 / 同国家换线
出口详情真实运行卡→自动恢复设置。默认关闭，必须确认自动联网/故障断线；启用后故障或控制服务重启会恢复。点击停止出口先持久pause并取消恢复，不会后台又重开。
选择最多3个当前官方、同逻辑出口国家的VPN备用；健康时不检测备用。每次尝试先确认原入口/出口停止，再用官方域名、系统CA和精确指纹验证一台候选，保存加密快照后执行器验真实DNS/TLS/出口IP，才开放代理监听。失败30秒起指数退避至15分钟，无宿主直连或DNS后备；缓存过期/全部不可用保持停止，不自动全列表扫描。
自备HTTP/HTTPS/SOCKS上游只重连原配置，不能暗中切VPN；无住宅证据不放行strict策略。逻辑监听地址/用户名/代理密码不变，Miku受管VLESS/Trojan/REALITY入口可明确恢复；REALITY重检目标但保留UUID/密码/密钥，资产失效时入口停止并显示原因。
健康探测失败立即撤销监听/会话；控制关闭等待恢复结束后再关闭数据库。人工启停/配置与每出口恢复互锁，用户取消不能晚到重启。状态显示阶段、失败次数、下一次时间和当前候选。
已有面板与维护
保留dev.13本机3x-ui网页CSRF登录、脱敏入口/持久路由预览、确认应用/面板重启、加密快照/失败恢复/网页回滚及未完成事务。面板登录密码不保存，当前只本机HTTP接口；官方实装版本/HTTPS-only支持仍待验证。
保留数据服务卸载：
sudo python3 -B /usr/local/lib/miku-gate/miku-maintain.py uninstall-services \
--output=/ROOT_PRIVATE_0700/new-snapshot.tar.gz \
--confirm-stop --confirm-uninstall-services
sudo python3 -B /usr/local/lib/miku-gate/miku-maintain.py reinstall-services \
--confirm-reinstall-services只确切Miku单元，保留DB/key/证书/程序/核心/专用账号，不卸载共享系统工具，不递归删除，不动原面板/防火墙。重新注册不自动启动或enable，需要管理员明确start。unit文件缺失也核对systemd实际LoadState/ActiveState/PID，不能误把活进程当停止。
验证与边界
新增受控恢复：默认关闭无启动、健康不查候选、候选失败退避/顺序、用户pause取消、国家/源/新鲜政策持久；实际gateway原监听端口重连后原SOCKS用户名密码认证通过，再pause不启动。业务session为受控夹具，不等于公共VPN实际自动换线或长稳。
新安装旅程保存真实加密数据、私有备份、程序升级与配套回滚；新增未确认卸载拒绝、实际服务卸载保留key/证书/账号、显式恢复注册不start/enable、显式启动后原HTTPS会话/加密配置可读。只有同源实际CI成功后按此门槛发布；失败记录仍保留。
仍待真实官方面板/已有独立Xray和sing-box持久兼容、公网完整客户端业务、root实际ACME/续期、installed数据面真实自动换线/长期恢复、跨机灾备等。全部目标和Issue保持开放；Windows包只控制/代理配置，Linux隔离与systemd不冒充Windows能力。
Miku Gate v0.1.0-dev.13 — 面板网页持久复用与保留数据维护预览
Miku Gate v0.1.0-dev.13 · 面板持久复用网页与保留数据维护预览
固定源376aef83b3298fb430497878862ee1c0af41f551。新增3x-ui本机网页流程：CSRF登录/脱敏入口、所选持久TCP路由预览、明确应用与加密快照回滚。另新增保留数据的服务卸载/恢复注册。仍是预览，实际官方面板版本与完整公网业务未最终验收。
安装与管理
核对SHA256SUMS，在root保护目录解压Linux amd64/arm64包后：
sudo sh scripts/install-vps.sh --plan-only
sudo sh scripts/install-vps.sh缺依赖先确认，域名/IP、端口、已有工具意图、受管Xray/sing-box/双核心、证书/最终应用逐项确认；不改原面板/宿主路由/防火墙，不抢80/443。无需Go/Node。无域名IP引导证书需核对指纹/导入信任，不忽略TLS。现有Miku安装用配套升级入口，不用首次安装覆盖保留数据。
3x-ui网页持久复用
系统与诊断→复用本机3x-ui已有节点。只明确127.0.0.1非特权面板端口/基础路径；新版current使用官方CSRF+panel/api/xray，旧版legacy显式选择，不遍历猜接口。
面板用户名/密码/两步码只用于本次本机登录，提交后输入清空；临时会话最多5分钟、绑定当前Miku管理员会话。返回脱敏入口标签/端口/协议，选择入口和实际Miku逻辑出口，输入该出口代理密码，先预览TCP到本机认证SOCKS和UDP阻断，再明确核心重启/快照同意。应用需健康实际监听出口，预览和当前模板/生成配置/候选摘要一致。
配置从面板持久API保存并让面板重建/重启，不直接覆盖bin/config.json生成物。应用后读回持久模板和生成路由、客户端和其他节点保留；配置回读不是已连接VPN的证明。失败自动恢复旧模板/生成配置，不确定时保留未完成事务与加密快照，阻止新应用。网页可重新登录后恢复快照；最多8份，可明确两步删除旧快照，不自动删备份。
目前仅本机HTTP监听面板；HTTPS-only/容器不在同回环/不兼容接口明确不可用，不跳过证书或CSRF。官方实装面板兼容和外部编辑/公网客户端业务仍待验，受控真实回环API夹具和网页旅程通过不替代真实面板验收。
schema7与配套密钥
新增面板旧模板/生成配置快照可能含节点/代理秘密，按实例/备份ID/分块顺序总数认证加密；不保存面板登录口令。schema升级7，避免旧程序忽略panel-only备份错误创建新key；原6实例/配置/key保留迁移，维护data-check检查6/7并真实验证加密快照。旧dev.12不能直接打开7；若需旧版，恢复整个旧程序/DB/key/证书/登记快照，不单独换程序或手工改user_version。
保留数据的服务卸载
sudo python3 -B /usr/local/lib/miku-gate/miku-maintain.py uninstall-services \
--output=/ROOT_PRIVATE_0700/new-snapshot.tar.gz \
--confirm-stop --confirm-uninstall-services
sudo python3 -B /usr/local/lib/miku-gate/miku-maintain.py reinstall-services \
--confirm-reinstall-services仅已登记的Miku单元，先验证模板/drop-in/身份和整套私有快照，再停止/disable/移除确切unit文件。数据库/key/证书/程序/核心/账号保留，不卸载共享OpenVPN包、不递归删目录、不碰旧面板/防火墙。恢复注册不自动enable/start；中断保留配套恢复日志。真实Linux卸载/恢复注册旅程尚待专项验证，不冒充完全清除型卸载。
原有能力和当前边界
保留dev.12域名证书更新/身份保持、地理/ASN/DNSBL辅助界面、OpenVPN隔离执行器、用户HTTP/HTTPS/SOCKS上游、同出口DNS、断线无直连、双核心VLESS TLS/Vision、REALITY/Vision、Trojan TLS、10候选与自填/客户端导入。
新Go回归包含真实回环面板CSRF/持久读写/恢复、管理员API计划/活动出口/失败回滚/网页快照恢复、AEAD分块/missing-key/8份/待恢复不可删；Chromium实际Miku登录→真实回环面板API→脱敏预览→无出口阻止和手机布局通过。官方实装3x-ui、root续期公网ACME、installed系统VPN长稳/自动換线、独立已有Xray/sing-box服务持久复用、最终公网部署和跨主机灾备未完成。Windows包为控制/代理配置预览，systemd/OpenVPN隔离仅Linux。