文档
四端装法不同,装完之后的界面和操作是同一套。先找到自己的平台。
Windows
需要 Windows 10 1809(内部版本 17763)或更高,x64 与 ARM64 各一个包。Windows 7 / 8 用不了,也不打算支持:Go 从 1.21 起不再支持它们,微软也停了那两个系统的 WebView2。
安装包会注册后台服务(自动启动)、装托盘客户端与命令行,可勾选"登录时自动启动",并注册 godusevpn:// 供落地页一键导入。
关掉窗口只是收进托盘,连接不断。托盘的"退出"才会断开连接并停掉后台服务,TUN 网卡随之消失。
macOS
需要 macOS 13(Ventura)或更高,苹果芯片与英特尔各一个包。两种装法,都要输一次开机密码:
不用终端:到 Releases 下载 godusevpn-<版本>-macos-arm64.tar.gz(苹果芯片)或 -amd64(英特尔),双击解开,照文件夹里的「安装说明」双击「安装佛跳墙.command」,在弹出的终端里输开机密码(问能否访问「下载」文件夹时点「好」)。第一次会被 macOS 拦一次:macOS 13 / 14 右键 →「打开」,macOS 15 起到「系统设置 → 隐私与安全性」点「仍要打开」。放行之后它清掉整个文件夹的隔离标记,装好的佛跳墙不会再被拦。
用终端(不会被拦,也不用放行):
curl -fsSL https://raw.githubusercontent.com/Maoyangui/godusevpn/master/deploy/macos-install.sh | sudo shcurl 这条不会被拦是因为 Gatekeeper 的"来自互联网"隔离标记是浏览器下载时打上的,curl 拿到的文件没有这个标记,所以不用买开发者证书。
装完是两样东西:
| 路径 | 是什么 |
|---|---|
/usr/local/bin/godusevpn | 守护进程兼命令行,注册成 launchd 服务开机自启 |
/Applications/godusevpn.app | 图形界面,启动台里叫「佛跳墙」 |
这一版没有菜单栏图标,关窗口只是关界面,隧道照常在后台跑,从启动台再打开就回来了。卸载:双击安装包里的「卸载佛跳墙.command」,或 sudo godusevpn uninstall 再删掉上面两个路径。
Linux 与软路由
一个静态二进制,既是服务也是命令行,自带浏览器面板。root 执行:
curl -fsSL https://raw.githubusercontent.com/Maoyangui/godusevpn/master/deploy/install.sh | sh装完终端会打印面板地址和随机生成的初始密码。默认监听 0.0.0.0:9800,本机和局域网其它设备直接打开。面板是明文 HTTP,从公网默认打不开:云主机上用 SSH 隧道(ssh -L 9800:127.0.0.1:9800 root@服务器)最省事,实在要直连再开下面那个开关并放行 TCP 9800。
| 要做的事 | 命令 |
|---|---|
| 改面板密码 | godusevpn passwd |
| 只给本机看 | godusevpn settings webListen=127.0.0.1:9800 |
| 允许从公网打开 | godusevpn settings webAllowPublic=on |
| 服务开关 | godusevpn install | start | stop | status | uninstall |
| 打开面板(桌面) | godusevpn open,或点应用菜单里的「佛跳墙」图标 |
桌面发行版(有应用菜单的)装完后,系统也认得 godusevpn:// 链接:在面板的订阅页上点「一键导入」,浏览器会打开本机面板、弹出已经填好地址和名字的添加订阅框,看一眼再点添加。订阅地址放在面板地址的 # 后面交给页面,不发给服务器、不进日志。软路由和没有桌面的服务器照旧在面板里粘贴地址。
访问记录不落盘:内核日志里每条连接的目标默认只留在内存里。系统日志里也不记 —— journald / logread、macOS 的 launchd 日志、梅林的崩溃记录文件(/opt/var/log/godusevpn.stderr.log)只收崩溃和服务没起来的原因,不再有连接目标。
网关模式(软路由)
设置 → 网络 → 网络模式选"网关",局域网设备把网关和 DNS 指向这台机器就被代理,设备的 DNS 查询由内核接管(fake-ip、防泄漏)。菜单里会多出"设备"页:自动发现在线设备,每台可设跟随规则 / 强制代理 / 直连 / 拒绝上网(「防流量逃逸」生效时「直连」不生效,照样走隧道),按 MAC 记住也按 MAC 生效:换 IP 马上跟着、不断别的设备,旧 IP 分给别人不会错套,IPv6 地址也算。
单网口旁路由同样能用,设备页只排除主路由自己。普通 Linux 默认不转发,连接时自动打开 IP 转发、断开关回去。需要内核带 nftables,OpenWrt 22.03 起的 fw4 都有。
Android
侧载 APK,最低 Android 8.0。手机与电视基本都是 arm64,不确定就装 universal 包。第一次点"连接"会弹系统的 VPN 授权。
Windows 上的"按进程直连"在这里是按应用包名(设置 → 分流),选中的应用整个绕过 VPN;全局模式下「防流量逃逸」开着时不生效,这些应用也走 VPN。同一个包在 Android TV 上以横屏显示,遥控器方向键能走完全部操作。
升级走应用内:下载对应 ABI 的 APK、校验 SHA256 后拉起系统安装器。每一版用同一把签名密钥,否则系统不让覆盖安装。第一次会让你允许"安装未知应用",没给权限会直接提示,不会卡在"正在安装"。
IPv4,关一下再开移动数据(有的运营商锁了 APN 改不了)。常用规则集(国内域名、国内 IP、广告)随安装包内置,内核启动不联网拿规则集,装完插上网线就能连。手机和电视上不开本地混合端口(流量全走 VPN,没人会连它);Clash API 的端口要是被别的代理应用占着,会自动换一个空闲的,不会因此连不上。
电视上左侧菜单能滚(矮屏幕也看得到"关于 / 导出诊断包"),日志框选中之后可以用上下键翻页;列表行右边的按钮按"右"键进得去。连接出错时首页会直接显示内核的原话,不再只有一句"内核启动失败"。
日常使用
第一次打开
先填面板给的订阅链接才能进入;没有订阅的话点"或手动添加节点",或者选购节点。之后在侧边菜单的"订阅管理"里可以加更多条,点一下切换。粘进来的地址不是 sing-box JSON 格式的(从 m-ui 落地页复制的 Clash 地址 ?format=clash、浏览器地址 ?format=page,或者不带 format),拉取时自动改成 format=json,粘哪个都能用。
手动添加节点
"添加订阅"下面的"或手动添加节点":贴分享链接(vless、vmess、trojan、ss、hysteria2、tuic、anytls、socks、http,可一次贴多条,也认 base64 和 sing-box 节点 JSON),或者选好协议逐项填写。保存前内核先干跑一遍,填错的不会存进去。这些节点归在一条"手动节点"里,点"使用"切过去后,节点列表、测速、规则的用法都和订阅一样,只存在本机。
续费
面板设置了「选购 / 续费」地址的话,订阅卡片上会多一颗续费按钮,点一下用系统浏览器打开。快到期或流量快用尽时它转橙色并写明还剩几天;已经到期、连订阅都拉不到时按钮也还在;面板没设置就不显示。
刷新订阅不断线
刷新拿到的增删立刻反映在节点列表里,正在用的连接一点不动,不用点"应用"。刚加进来的或参数改了的节点,选中时会重建配置重连一次。只有正在用的那个节点被面板删掉或改了参数才自动重连。
三种模式
| 模式 | 行为 |
|---|---|
| 规则 | 国内域名与 IP 直连,其余走代理。默认的三条分支自己可以改。 |
| 全局 | 全部流量走代理。 |
| 直连 | 全部流量直连,隧道还在但不转发。 |
切模式靠内核的 Clash API,毫秒级,不重启内核。首页下方和侧边菜单里都能切。
防流量逃逸
设置 → 隐私里的开关,默认开。只要还连着,该走隧道的流量就不许从本机网络出去 —— 隧道没起来、内核在重启、节点不通、崩了在重试、设备重启,统统只能等,不漏。规则模式下防火墙照着规则放行:直连规则里的 IP 段(默认是局域网和国内 IP)照常直连,其余只能等;防火墙只认 IP 段,按域名、进程、端口写的直连规则要等隧道恢复;Android 系统不支持按规则放行,隧道异常时直连也要等。撤闸后系统防火墙回到原样。
全局模式下放行的只有隧道自己、回环,以及「局域网直通」开着时的局域网 —— DNS 除外:Windows 与 macOS 上发往任何地址的 DNS 查询只许走隧道,隧道断开的空档里也不许发给路由器(Linux 用策略路由把 DNS 接进隧道,空档里同样被拦,要内核 4.17 起);UPnP 发现(SSDP)与 NAT-PMP / PCP 也不放行 —— 程序能靠它们向路由器问到宽带的公网 IPv4,所以连着时局域网投屏、设备自动发现用不了,手动填 IP 访问照常。Windows 用系统过滤平台的持久规则,macOS 用 pf,Linux 用 nftables,Android 靠内核重启时不关 VPN 接口。闸不随服务退出而消失——强杀、崩溃、升级都在,机器重启后开机就先装上(Windows 连开机到防火墙引擎启动之间那几秒也堵着;Linux 早于联网;macOS 由 launchd 开机拉起,不保证早于联网;梅林开机到守护进程起来之间那几秒没有闸),只有断开、切模式、关开关、卸载才撤;服务起不来时用托盘菜单或开始菜单的「恢复网络」解除。生效时首页有一颗「防逃逸已生效」的小盾。
选节点
点首页的出口卡片或"节点"格子打开列表。打开时测一次速,之后不再定时测——只有选了"自动选择"或某条线路(见下)才会按设置里的周期测,并切到最快的那个:自动选择测全部可用节点,选了线路只测这条线路自己的服务器;IPv6 节点和提示节点都不测。列表顶上按地区归堆,点标签只看该地区;名字里写了倍率(2x / x2 / 0.5倍)会单独标出来。
标着「IPv6 节点」的是这一轮不用的:节点只能走 IPv6(地址写成 IPv6,或者域名只有 AAAA 记录),而「允许 IPv6」关着(出厂就是关,不分平台)。它们不进自动选择和线路自动,测速也不测;选它照样能选上,但连不通,首页点名是哪个节点、写明到 设置 → 隐私 打开「允许 IPv6」(状态码 E_NODE_V6)。域名只有 AAAA 记录的是连接时解析节点域名顺带认出来的,全局 +「防流量逃逸」下本地 DNS 是 system 或域名形式的 DoH 时不做这次解析,认不出来,只是不会提前标出来。
标着「提示」的是面板放在订阅里显示用量、到期、续费的「节点」(m-ui 的「00-勿选-流量…」、管理员自建的「续费提示」:地址是本机、端口小于 1024,或者写成 0.0.0.0),不是能连的节点:自动选择和线路自动都不用它们,测速也不测。手动选它照样能选上,但上不了网,界面会说一句。写着本机地址的 socks / http 节点(接本机另一个代理)和本机高端口上的转发照常当节点用。
线路自动
面板把一条线路部署在好几台服务器上时(需要面板 m-ui 0.7.17 及以上,它才在订阅里给这种线路出线路组),节点列表最上面多一个「线路自动」开关。打开后同一线路的几台合成一项,小字写"自动 · N 台";选它就只在这条线路自己的服务器里自动用最快的那台,线路和出口不变 —— 和"自动选择"不同,自动选择在全部节点里挑,可能换到别的线路。关掉时列表回到一台一台列,原来选的是线路的就固定到组里此刻在用的那台。连接时、定时测速、自救都只测这一组的服务器;在用的那台挂了(连接失败、健康检查不通)当场只测这一组、换到组里通的那台,一般十几秒内恢复,不出这条线路(hysteria2 / TUIC 被封时要先等会话看护判废,一般一两分钟);头一回选某条线路会重连一次,之后就地切换。线路减到一台时先用剩下那台、首页写明,面板恢复多台后自动回到线路自动。旧面板、或订阅里没有能合并的线路时不显示这个开关。
有新版本时
连着时客户端每小时经节点查一次,没连接时不自动查(「关于」里可以手动检查)。有新版本时首页顶栏"佛跳墙"旁边亮一个红色 NEW,侧栏"关于"也带 NEW;点 NEW 直接到"关于",升级并重启,设置与订阅都保留。
出口地址
首页那一行是经当前节点查来的,不是节点名上写的机房位置(节点自己再套一层就不是那儿了)。换节点立刻重测,自动选择在后台切了也重测,此外每 10 分钟复查一次。查不到就显示"正在查出口",不影响使用。
路由规则
内置一组默认规则:局域网与私网直连、国内域名与 IP 直连、其余走代理。这三项各自可改(直连 / 代理 / 拒绝;"其余流量"只能选代理或直连),改乱了点"还原默认"一步回出厂。
自定义规则组要填三样:
| 字段 | 说明 |
|---|---|
| 名称 | 自己看的,比如"流媒体" |
| 出口 | 代理 / 直连 / 拒绝 / 自动选择 / 某个具体节点 |
| 条件 | 域名后缀、完整域名、关键词、正则、IP 段、端口、进程名、geosite 类别、geoip 国家;任一命中即算命中 |
规则组自上而下依次匹配,排在默认规则之前,只在"规则"模式下生效,可启停、排序、编辑、删除。出口选了具体节点而它不在当前订阅里时,回落到代理。
关于 IPv6
默认全关,分五层:
- DNS 只回 A 记录
- 不分配 IPv6 的 fake-ip 段
- 隧道里按目标协议族拒绝
- TUN 照样声明 IPv6 地址,把 v6 流量接进隧道再丢掉——不接进来的话它会绕过隧道从物理网卡直接出网
- 连接期间停用各网卡的 IPv6 协议
最后一层是关键。前四层挡的都是"IPv6 数据包出网",挡不住"读取本机网卡配置":运营商发下来的公网 IPv6 地址就配在物理网卡上,原生程序(不是网页,浏览器沙箱不给读)枚举一遍网卡就能读走,再经隧道报给自己的服务器——数据包一点没漏,信息漏了,而那个前缀对应到具体一条宽带线路。
动手前每张网卡的状态会落盘,断开时按状态还原;守护进程启动时对账一次:上次不是连着关的机就还原回去(崩溃退出不会把 IPv6 永久关掉),上次是连着关的机就接着关着 —— 它和「防流量逃逸」的闸一样是持久的。本来就是关闭状态的网卡记下来但不动。要保留局域网 IPv6 就在设置里把这个开关关掉。
「允许 IPv6」关着时,只能走 IPv6 的节点(地址写成 IPv6、域名只有 AAAA 记录)也不用,见上面"选节点";服务和界面自己直连发出的请求(没连接时拉订阅、检查更新、下载安装包、补规则集、DoH)同样只走 IPv4。
命令行
Windows 上以管理员身份;Linux 与 macOS 是同一个 godusevpn 二进制,子命令一样。
godusevpn-svc install 注册服务并启动
godusevpn-cli profile https://面板/sub/用户名 设置订阅
godusevpn-cli connect
godusevpn-cli status
godusevpn-cli mode global | rule | direct
godusevpn-cli nodes / select <节点> / test
godusevpn-cli node add <分享链接...> / list / rm <节点名>
godusevpn-cli settings ipv6=on probeMinutes=5 logDays=14
godusevpn-cli logs 200 core
godusevpn-cli diag 打印诊断信息(订阅地址、凭据、访问记录已打码)
godusevpn-svc uninstall排障
界面显示"服务未运行"
关于页点"修复服务"。Windows 上也可以 godusevpn-svc install 重装一次。macOS 的界面是用户身份跑的,要靠 root 守护进程开出来的套接字,重装服务能一并修好权限。
连上了但打不开网页
先看日志(侧边菜单 → 日志,切到"内核")。上面一排能按去向筛选:点"走隧道""直连""拦截"只看这一类连接,每条写着哪个程序连了哪个域名、走的哪个节点;点"DNS"只看解析记录;点某行的连接号只看这一条连接的全部日志。常见原因是订阅里的节点已经不通,换一个节点或点"重新测速"看看哪些还活着。
订阅刷新失败
刷新会自动回退:经当前节点失败就改用自动选择组,再不行直连刷新。三条都失败基本是链接本身的问题——到订阅管理里核对地址,或者账号已停用 / 用完 / 到期。
远程 SSH 会不会被切断
不会。Linux 上外部连进来的连接(SSH、面板)由连接跟踪认出来,回包走原来的路由、不进 TUN,连上之前就开着的会话也一样;本机往外连的(包括绑物理网卡地址的 WebRTC)照样走隧道。
要提交问题
内核日志里每条连接的目标默认只留在内存里,服务重启就没了;问题要隔很久才复现的话,到设置 → 日志打开「内核日志写入磁盘」。
日志 → 导出诊断包,里面订阅地址已经打码。连同现象一起发到 Issues。