v2ray.fun

A easily command interaction manager for v2ray
一个简单的 v2ray 管理工具

开发 v2ray.fun 的目的（Purpose of developing v2ray.fun）

Every human has his/her own specialties, they may not skilled enough to familiar with complex configurations about how to config proxy tools and know everything about it, so I wish you can achieve a benifit over this tool and escape variety censorships before access internet safely, conveniently, rapidly, freely.

术业有专攻，有些人可能没有足够娴熟的技术，洞察某些代理工具的使用规则，但我希望他们可以借某些工具，从复杂的调参中解脱出来，摆脱某些机构的审查，以安全、便捷、快速、自由地访问互联网。

目录（Catalogs）

• V2ray.fun
  • 项目简介
  • 功能
  • 客户端
  • 安装命令
  • 升级命令
  • 卸载命令
  • 截图
  • 系统要求
  • 软件要求
  • 更新日志
  • 特别说明

项目简介

v2ray.fun 是一款用于控制、配置 v2ray Linux 服务端的脚本程序，程序以交互式向导模式，向用户提供更改端口，加密方式，传输协议等功能，可省去手动配置大段 v2ray 配置文件可能出现的格式错误、配置错误等麻烦，尽情享受V2ray的乐趣~~

功能

• 一键 启动 / 停止 / 重启 V2ray 服务端
• 自动随机生成 UUID，自助修改指定的 UUID
• 自助修改端口
• 快速查看服务器连接信息
• 每周定时清理日志，重启服务，更新广告过滤策略，避免日志文件大量占用服务端空间，程序长期运行卡死等问题
• CentOS 6 完美支持
• 一键下载客户端配置文件和二维码（通过szrz程序，xshell，secureCRT还有macOS的iterm2都支持）
• 提供全平台v2ray客户端下载（不包含iOS shadowrocket）
• 自由更改传输配置：
  • 常规TCP
  • HTTP头部伪装
  • WebSocket流量
  • 常规mKCP流量
  • mKCP 伪装 FaceTime通话流量
  • mKCP 伪装 BT下载流量
  • mKCP 伪装 微信视频通话流量
• 可设置“路径”（path）参数（配合 web 服务器分流使用）

WebSocket 传输不包括 web 服务器分流，请自行安装 Nginx/Apache/Caddy 等分流（当配置 WebSocket 功能时，如果不输入域名，程序把 v2ray 配置文件自动设置成监听本地 127.0.0.1 地址，用来接应 Web 服务器分流，我准备未来择机加入一键安装并配置 Caddy + ws + tls 的功能）。

客户端

• 如需要 v2ray Android/Mac/Windows 客户端，请移步至本项目 https://github.com/leitbogioro/v2ray.fun/releases 页面寻找最新版，iOS 客户端因为 iOS 特殊的应用权限设置，你只能自己想办法去获得（中国区 AppStore 下架了所有跟 v2ray 相关的应用），Linux 版客户端正在开发中。

安装命令

bash -c "$(curl -fsSL https://git.io/fh9As)"

升级命令

bash -c "$(curl -fsSL https://git.io/fh9AZ)"

卸载命令

bash -c "$(curl -fsSL https://git.io/fh9AC)"

截图

系统要求（以下默认均为 x64 版，x86 版因 nodejs 等组件无法安装，故不提供支持！）

OS Requiremets(These following OS are default x64 version, x86 versions are not supported and don't install on them!)

• Debian 7
• Debian 8
• Debian 9（推荐 Recommended）
• Ubuntu 14
• Ubuntu 16（推荐 Recommended）
• Ubuntu 18
• CentOS 6（独家 This is the unique version can be installed on this OS despite v2ray official don't support CentOS6）
• CentOS 7

软件要求

请使用Xshell连接服务器，以获得完美的中文支持以及配置文件下载功能。

更新日志

• 第一版通过测试发布（2017.9.4）。

• 新增TLS功能，自动获取证书（2017.10.16）。

• 支持修改alterID（2018.5.1）。

• 支持动态端口的使能和禁止（2018.5.1）。

• 支持修改动态端口的范围（2018.6.11）

• 增加菜单：更新 v2ray 以及 v2ray.fun（2018.6.11）

• 支持生成v2rayN(windows以及安卓) & Pepi(IOS) 客户端的 vmess 链接和 qrcode 图片，支持通过用 sz 将配置详情的二维码图片下载到本地。（2018.7.7）

• 由 tracyone 维护的 v2ray.fun 项目已被删除，本人稍作修改暂可继续使用。（2019.2.7） Attention! 如果您安装了之前由tracyone编写的项目，请不要贸然使用全新安装的方式升级，否则会使您当前安装的v2ray配置文件被重设以至于无法正常工作！

• 修改广告过滤功能实现的方式，将v2ray所依赖的 config.json 配置文件中冗长的域名列表去除，采用外挂ToutyRater 制作的 h2y.dat 文件中的广告过滤规则，不但减轻了操作 config.json 文件的压力，还让广告过滤列表可以随时方便地更新。项目地址。（2019.2.17）

• 经测试，动态多端口功能并不能有效提高对 GFW 的欺骗，故将该功能设置为默认关闭的状态。（2019.2.17）

• 修复了一处在主程序启动时更新 v2ray 会导致配置文件被贸然删除的错误。（2019.2.19）

• 如果检查到运行环境中存在阿里云服务，安装将立即终止。（2019.3.3）

• 新增替换原来的广告过滤策略并采用新的广告过滤策略。（2019.3.4）

• 为老用户（有旧配置文件的）提供删除原配置文件中冗长的广告过滤配置文件并采用新的广告过滤策略功能，做到平滑过渡。（2019.3.4）

• 独家为 CentOS 6 系统提供兼容性支持（v2ray官方版暂不支持在 CentOS 6 上运行）。（2019.3.17）

• 由于操作失误，本项目被误删，经过一天的抢救，现已恢复。（2019.3.20）

• 新增自动更新广告过滤策略的能力。（2019.3.23）

• 如果服务端采用了 ws（websocket）协议，并正在监听 localhost （127.0.0.1），配合 v2ray.fun 服务端的端口设置，可视为该服务端正对本地（特指服务端的本地）的某个端口进行监听，并和 Nginx/Caddy/Apache 等 Web 服务器在本地建立起连接的行为，然后由 Web 服务器对该本地的通信通道做一次转发，将其映射到公网外部，以便外部的 Client （客户端）能够直接以 websocket 协议，在该服务器 443 端口上发起 https 连接，经过该 Web 服务器的反向转发（相对于服务端本地的向外转发），得以与隐藏在该 Web 服务器的 https 网站的某个目录下（可选设置）的 v2ray 服务端建立通信。故对应显示的客户端 url 配置中的端口，应当是 443，且默认开启 tls。

• 修改安装时生成随机端口的策略。（2019.3.23）

• 安装完成后，为 /usr/local/v2ray.fun 文件夹中的主要程序文件增加权限。（2019.3.23）

• 修复了因判断逻辑错误，CentOS 无法正确安装的问题。（2019.4.10）

• 更新 Websocket 模式下添加 path 参数的功能。（2019.6.2）

• 更新自定义 UUID 的功能。（2019.6.3）

• 添加自动维护功能，该功能包含：每周自动重启 v2ray 服务、更新广告过滤规则、清理访问日志、清理错误日志。（2019.7.31）

• 由于选用ws模式时，程序自动在配置文件的inbound>streamsettings>listen中写入本地地址，调回tcp模式的时候，这个值没有被写回来，所以我在写入json模块中“调整为tcp传输模式”选项里，加入一条将inbound中的listen参数强制拨回为null的指令，问题已修复。（2019.8.16）

• 升级 PC 客户端、Android 客户端版本。（2019.8.24）

• 升级 PC 客户端版本，由于该客户端依赖 Net_Framework_4.7.2，故提供该组件的离线安装包下载程序。（2019.9.20）

• 升级 PC 客户端、Android、Mac 客户端版本。（2019.11.4）

• 修复自动维护功能的逻辑判断，优化自动维护功能。（2019.11.5）

• 在安装和升级程序中，修复判断加入自动维护功能定时运行逻辑，并重启一次 crontab 服务使更改生效。（2019.11.5）

• 更新客户端版本（2019.12.27）

• 由于 v2ray 主程序安装脚本 https://install.direct/go.sh 已改版，不再提供原来的方案安装，项目已迁移至 https://github.com/v2fly/fhs-install-v2ray， 但该项目中提供的新安装方法对 v2ray 主程序生成的配置文件与旧版本 config.json 不兼容，以及将 v2ray 主程序生成可输入 v2ray 直接启动的软链接，与本程序启动命令 v2ray 相冲突。鉴于以上两种改动对本项目的兼容性产生较大影响，故根据该页面在2020年7月22日17:33:59形成的历史快照中的源代码：https://web.archive.org/web/20200622173359/https://install.direct/go.sh ，将 install.sh 中安装 v2ray 主程序的安装脚本回滚为历史版本，代码参见：https://github.com/leitbogioro/v2ray.fun/blob/master/go.sh 。并同样将该脚本在 update.sh 中，替换掉原来的 v2ray 安装脚本链接。(2020.8.15)

• v2ray linux x64 4.27.5 版本（以下简称“v2ray 4.27.5”，文件来源链接：https://github.com/v2ray/v2ray-core/releases/download/v4.27.5/v2ray-linux-64.zip ）的主程序压缩包根目录中，缺失了以前版本具备的“systemv”文件夹与下级目录“v2ray”文件；以及“v2ray.service”并没有出现在“systemd”的根目录中，而是在“systemd”的下属目录“system”中。以上两个文件，“/systemv/v2ray”起到为采用“init.d”方式管理程序服务项的系统，如 CentOS 等提供注册、启动并管理 v2ray 服务的作用；“/systemd/v2ray.service”起到为采用“systemd”方式管理程序服务项的系统，如 Debian/Ubuntu 等提供注册、启动并管理 v2ray 服务的作用。鉴于以上两种 v2ray 程序服务注册文件作用的描述和它们在 v2ray 4.27.5 版本程序包中的缺失、路径错误，导致本项目一旦在新环境中安装完成后，v2ray 程序无法正常运行（如果你在 v2ray 4.27.5 这个版本发布前就已安装了本项目，因为已经正确部署了系统服务，所以升级主程序并不会影响你的环境中 v2ray 的正常运行）。本项目从上一个 v2ray linux x64 4.27.0 版本（文件来源链接：https://github.com/v2ray/v2ray-core/releases/download/v4.27.0/v2ray-linux-64.zip ）内，找回了与注册 v2ray 系统服务有关的两个文件：“/systemv/v2ray”和“/systemd/v2ray.service”，并将它们迁移到本项目的“add-on”分支（https://github.com/leitbogioro/v2ray.fun/tree/add-ons ），在部署安装时，直接使用本项目提供的 v2ray 系统服务注册文件，不再采用 v2ray 官方主程序包里提供的文件，避免全新环境下安装出现错误。（2020.8.15）

• 由于 v2ray 官方彻底放弃了https://github.com/v2ray/ 及分支下的各版本主程序文件的提供、并修改了获取文件版本号的api，导致本项目获取的主程序文件版本号有误，并且无法正确下载主程序并安装，给使用该项目的朋友们带来不便，敬请谅解。项目的新地址如下： https://github.com/v2fly/ ，获取主程序最新版本号的api变为：https://api.github.com/repos/v2fly/v2ray-core/releases/latest ，下载地址变量名改为：https://github.com/v2fly/v2ray-core/releases/download/$RELEASE_VERSION/v2ray-linux-$MACHINE.zip ，修正后，本项目可以正常获取新的v2ray主程序版本号，并正常下载并部署v2ray主程序文件。（2021.3.12）

• 由于 v2ray 在2022年1月1日起，正式启用 VMess MD5 认证信息的淘汰机制，即服务器端将默认禁用对于 MD5 认证信息的兼容。任何使用 MD5 认证信息的客户端将无法连接到禁用 VMess MD5 认证信息的服务器端。在服务器端可以通过设置环境变量 v2ray.vmess.aead.forced = true 以关闭对于 MD5 认证信息的兼容。 或者 v2ray.vmess.aead.forced = false 以强制开启对于 MD5 认证信息认证机制的兼容，如果你的 v2ray 服务端和客户端都设置了 AlterID 为非0值，该机制都会对你 v2ray 的正常运行造成影响，故本次在 v2ray.service 中添加“Environment="V2RAY_VMESS_AEAD_FORCED=false"”来消除该影响，但为了安全考虑，强烈建议你的 v2ray 服务端和客户端都更新到最新版本，并关闭 VMess MD5 认证功能（将 AlterID 设置为0，服务端和客户端需同步设置）。参见：https://github.com/Jrohy/multi-v2ray/issues/561 （2022.6.12）

• 关闭 Debian 9 及以下版本已过期的 DST Root CA X3 证书验证。（2022.6.12）

• 更新 nodejs 至 14。（2022.10.3）

• 由于 v2ray 已更新到 5.0 以上版本，安装方法和配置方式和旧版有所区别，与该脚本不相适应，该管理脚本将 v2ray 核心停留在 v2ray 4.0 最后一个版本： 4.45.2，并停止功能更新，v2ray 4.0 核心来自：https://github.com/v2fly/v2ray-core/releases/v4.45.2 。（2022.10.3）

特别说明 && 致谢

也可以先查看下本仓库的wiki

本程序遵循 GPL v3协议发布，如想 Fork/修改，烦请把以下跟此项目有关的变迁和来源，贴到您项目的 README.md 中，谢谢！

V2ray : https://v2ray.com

一代目（已转型，正开发全新的v2ray.fun项目: https://github.com/FunctionClub/V2ray.Fun ）: 雨落无声

二代目（已引退）: tracyone

三代目（在服役）: leitbogioro

本项目从 wpyok500 备份的 https://github.com/wpyok500/v2ray.fun-1 项目 fork 而来，如有问题，欢迎随时提交 issues 反馈