README 未给出运行示例,需自行查阅官方文档配置;需单独准备配置文件才能启动;部分发行版需通过第三方打包源安装
v2ray-core
v2flyMIT活跃维护用 Go 写的代理平台,支持 VMess、VLESS、Shadowsocks、Trojan 等协议,帮你在受限网络里搭建翻墙通道。
A platform for building proxies to bypass network restrictions.
go install github.com/v2fly/v2ray-core/v5@latestREADME 未说明硬件要求,作为 Go 网络程序通常可在常见 CPU 与服务器上运行
用 Go 编写的代理平台,帮你搭建自己的网络、加密连接并保护隐私
用 Go 写的代理平台,支持 VMess、VLESS、Shadowsocks、Trojan 等协议,帮你在受限网络里搭建翻墙通道。
核心能力
- 支持 WebSocket、QUIC 等多种传输方式
- 内置 SOCKS 与 HTTP 代理协议支持
- 用 Cuckoo Filter 做路由与域名匹配
- 提供 Starlark 脚本扩展配置能力
- 支持 PROXY protocol 传递真实来源地址
容易踩的坑
- v5.56.0pre-release最新正式版2026-11-01 · 2026-11-01 13:38 UTC
The machine generated changes includes in this release will subject to review and changes once the maintainer recovers from temporary incapacitation and is not covered by API stability policies.
Mptcp is now disabled by default, for next 8 mid version releases to compensate for Linux tcp stack vulnerabilities.
Dependencies updated.
What's Changed
- Machine generated/mptcp default and dependencies 20261101 by @xiaokangwang in https://github.com/v2fly/v2ray-core/pull/3865
Full Changelog: https://github.com/v2fly/v2ray-core/compare/v5.55.0...v5.56.0
- v5.55.0pre-release2026-10-20 · 2026-10-20 19:00 UTC
查看更新说明
this is a maintenance release containing security updates for end users. The machine generated changes includes in this release will subject to review and changes once the maintainer recovers from temporary incapacitation and is not covered by API stability policies.
What's Changed
- Machine generated/update go dependencies by @xiaokangwang in https://github.com/v2fly/v2ray-core/pull/3857
Full Changelog: https://github.com/v2fly/v2ray-core/compare/v5.54.2...v5.55.0
- v5.54.2pre-release2026-09-22 · 2026-09-22 09:37 UTC
查看更新说明
Security Update
This update fixes an issue with quic transport where it sends V2Ray specific handshake parameters that differs from quic-go defaults. Thanks Jackson Sippe, et al. for reporting this issue.
This update includes a change that requires a protocol update of QUIC transport. Please update the server first to allow connections from both older and latest clients with a transition graceful period. This transition period will last until v5.61.0, and you end this transition immediately by manually setting QUIC transport's server alpn to h3.
-----> ⚠️ Important Message ⚠️<-----
This update includes security fix recommended for QUIC transport.
-----> ⚠️ 重要消息 ⚠️<-----
本更新含适用于 QUIC transport 的安全更新。
New Features
- Add iOS Client Support Bundle: Packet Bridge Receiver, Subscription Improvment, DNS and other udp improvement in https://github.com/v2fly/v2ray-core/pull/3809
- Add Wireguard Chain Proxy Support in https://github.com/v2fly/v2ray-core/pull/3816
Fixes
- Add safe defaults for QUIC connections in https://github.com/v2fly/v2ray-core/pull/3820
- Add safe defaults for QUIC connections on server side in https://github.com/v2fly/v2ray-core/pull/3830
- Allow quic server to accept clients with mismatching alpn temporaryly
Chores
- Fix: CI tests failures by @Loyalsoldier in https://github.com/v2fly/v2ray-core/pull/3790
- Chore: bump golang.org/x/crypto from 0.54.0 to 0.55.0 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3803
- Chore: bump google.golang.org/grpc from 1.83.0 to 1.83.2 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3817
- Chore: bump github.com/go-chi/chi/v5 from 5.3.1 to 5.3.2 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3815
- Chore: bump github.com/miekg/dns from 1.1.72 to 1.1.73 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3813
- Chore: bump github.com/pion/stun/v3 from 3.1.6 to 3.1.7 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3808
- Chore: bump google.golang.org/protobuf from 1.36.11 to 1.36.12 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3802
- Chore: bump github.com/stretchr/testify from 1.12.0 to 1.12.1 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3807
- Chore: bump golang.org/x/net from 0.58.0 to 0.59.0 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3805
Full Changelog: https://github.com/v2fly/v2ray-core/compare/v5.53.0...v5.54.1
- v5.54.1pre-release2026-09-21 · 2026-09-21 21:26 UTC
查看更新说明
Security Update
This update fixes an issue with quic transport where it sends V2Ray specific handshake parameters that differs from quic-go defaults. Thanks Jackson Sippe, et al. for reporting this issue.
-----> ⚠️ Important Message ⚠️<-----
This update includes security fix recommended for QUIC transport.
-----> ⚠️ 重要消息 ⚠️<-----
本更新含适用于 QUIC transport 的安全更新。
New Features
- Add iOS Client Support Bundle: Packet Bridge Receiver, Subscription Improvment, DNS and other udp improvement in https://github.com/v2fly/v2ray-core/pull/3809
- Add Wireguard Chain Proxy Support in https://github.com/v2fly/v2ray-core/pull/3816
Fixes
- Add safe defaults for QUIC connections in https://github.com/v2fly/v2ray-core/pull/3820
Chores
- Fix: CI tests failures by @Loyalsoldier in https://github.com/v2fly/v2ray-core/pull/3790
- Chore: bump golang.org/x/crypto from 0.54.0 to 0.55.0 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3803
- Chore: bump google.golang.org/grpc from 1.83.0 to 1.83.2 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3817
- Chore: bump github.com/go-chi/chi/v5 from 5.3.1 to 5.3.2 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3815
- Chore: bump github.com/miekg/dns from 1.1.72 to 1.1.73 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3813
- Chore: bump github.com/pion/stun/v3 from 3.1.6 to 3.1.7 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3808
- Chore: bump google.golang.org/protobuf from 1.36.11 to 1.36.12 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3802
- Chore: bump github.com/stretchr/testify from 1.12.0 to 1.12.1 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3807
- Chore: bump golang.org/x/net from 0.58.0 to 0.59.0 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3805
Full Changelog: https://github.com/v2fly/v2ray-core/compare/v5.53.0...v5.54.1
- v5.54.0pre-release2026-09-20 · 2026-09-20 20:09 UTC
查看更新说明
New Features
- Add iOS Client Support Bundle: Packet Bridge Receiver, Subscription Improvment, DNS and other udp improvement in https://github.com/v2fly/v2ray-core/pull/3809
- Add Wireguard Chain Proxy Support in https://github.com/v2fly/v2ray-core/pull/3816
Chores
- Fix: CI tests failures by @Loyalsoldier in https://github.com/v2fly/v2ray-core/pull/3790
- Chore: bump golang.org/x/crypto from 0.54.0 to 0.55.0 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3803
- Chore: bump google.golang.org/grpc from 1.83.0 to 1.83.2 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3817
- Chore: bump github.com/go-chi/chi/v5 from 5.3.1 to 5.3.2 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3815
- Chore: bump github.com/miekg/dns from 1.1.72 to 1.1.73 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3813
- Chore: bump github.com/pion/stun/v3 from 3.1.6 to 3.1.7 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3808
- Chore: bump google.golang.org/protobuf from 1.36.11 to 1.36.12 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3802
- Chore: bump github.com/stretchr/testify from 1.12.0 to 1.12.1 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3807
- Chore: bump golang.org/x/net from 0.58.0 to 0.59.0 by @dependabot[bot] in https://github.com/v2fly/v2ray-core/pull/3805
Full Changelog: https://github.com/v2fly/v2ray-core/compare/v5.53.0...v5.54.0
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Related Links
- Documentation and Newcomer's Instructions
- Welcome to translate V2Ray documents via Transifex
Packaging Status
If you are willing to package V2Ray for other distros/platforms, please let us know or seek for help via GitHub issues.
License
Credits
This repo relies on the following third-party projects:
-
In production:
-
For testing only: