{"id":21441789,"url":"https://github.com/dreamrover/v2ray-deb","last_synced_at":"2025-08-20T20:32:22.968Z","repository":{"id":48831707,"uuid":"224947270","full_name":"dreamrover/v2ray-deb","owner":"dreamrover","description":"v2ray debian/ubuntu安装包","archived":false,"fork":false,"pushed_at":"2022-07-29T09:38:00.000Z","size":208644,"stargazers_count":169,"open_issues_count":0,"forks_count":51,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-07T20:49:58.739Z","etag":null,"topics":["amd64","deb-packages","debian","installer","projectv","ubuntu","v2ray"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dreamrover.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-11-30T02:11:05.000Z","updated_at":"2025-03-18T09:27:47.000Z","dependencies_parsed_at":"2022-09-01T10:42:00.453Z","dependency_job_id":null,"html_url":"https://github.com/dreamrover/v2ray-deb","commit_stats":null,"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/dreamrover/v2ray-deb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dreamrover%2Fv2ray-deb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dreamrover%2Fv2ray-deb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dreamrover%2Fv2ray-deb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dreamrover%2Fv2ray-deb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dreamrover","download_url":"https://codeload.github.com/dreamrover/v2ray-deb/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dreamrover%2Fv2ray-deb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271378680,"owners_count":24749192,"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","status":"online","status_checked_at":"2025-08-20T02:00:09.606Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["amd64","deb-packages","debian","installer","projectv","ubuntu","v2ray"],"created_at":"2024-11-23T01:42:27.641Z","updated_at":"2025-08-20T20:32:20.181Z","avatar_url":"https://github.com/dreamrover.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# v2ray-deb\n## 简介\n科学上网工具[Project V](https://www.v2ray.com/)的Linux服务端/客户端配置比较复杂，而官网[v2ray-core releases](https://github.com/v2fly/v2ray-core/releases)仅提供了各平台的二进制压缩包，安装部署比较麻烦。\n\n本项目将其打包成Debian/Ubuntu系统上的deb安装包（仅提供x86_64版，如需其他CPU平台的安装包请[自行打包](https://github.com/dreamrover/v2ray-deb#%E8%87%AA%E8%A1%8C%E6%89%93%E5%8C%85)），使您能一键部署v2ray的Linux服务端/客户端，默认使用VMESS协议，安装后自动随机生成端口号和用户ID。\n\n配置文件位于/etc/v2ray目录下，服务端和客户端配置文件分别为server.json和client.json，安装完成后默认配置为服务端，创建指向server.json的符号链接文件config.json。您也可以在安装之后修改默认配置文件来重置端口号和用户ID，也可以修改符号链接文件/etc/v2ray/config.json的指向来将其作为客户端使用。\n\n作为服务端时，安装完成后自动生成的端口号为TCP端口号，同时也是基于UDP的mKCP的端口号，UUID相同，您可以在与此服务端连接的客户端使用TCP或mKCP，但不建议您使用m[KCP](https://github.com/skywind3000/kcp)，因为用了之后此端口和IP很快会被探测到进而被封，原因你懂的。另外，安装完成后服务端也默认支持基于UDP的[QUIC](https://zh.wikipedia.org/wiki/%E5%BF%AB%E9%80%9FUDP%E7%BD%91%E7%BB%9C%E8%BF%9E%E6%8E%A5)协议传输，端口号为前述自动生成的端口号加1，UUID相同，key也与UUID相同，同样不建议您使用QUIC，原因与mKCP相同，虽然这两个基于UDP的协议速度更快。\n\n服务端的配置信息都保存在/etc/v2ray/server.json中，包含TCP/mKCP/QUIC。客户端的配置信息都保存在/etc/v2ray/client.json中，仅包含TCP的配置信息，inbounds中的本地socks5代理为1080端口，HTTP代理为8080端口；outbounds中的端口号和UUID与服务端相同。\n### 注意1\n从v2ray 4.26.0版开始，v2ray已进入Debian 11 (Bullseye)官方源，使用apt-get upgrade命令会自动更新至官方源的版本，但实测发现此版本作为服务端时无法配置为同时监听多个端口，导致使用以前的配置文件无法启动v2ray。个人认为Debian官方源打包的v2ray非常糟糕，您可通过以下命令忽略Debian官方源的v2ray更新：\n* sudo apt-mark hold v2ray\n### 注意2\n安卓手机客户端[v2rayNG](https://github.com/2dust/v2rayNG)升级至1.4.13版本后，当前默认配置下无法与4.27.5及更低版本的v2ray服务端连接，请将v2ray服务端版本升级至4.28.2及以上。\n## 安装\n本项目打包软件的版本号与官网保持一致，您可以直接下载[deb安装包](https://github.com/dreamrover/v2ray-deb/releases)：\n* wget https://github.com/dreamrover/v2ray-deb/releases/download/4.45.2/v2ray-4.45.2-amd64.deb\n\n并通过如下命令安装：\n* sudo dpkg -i v2ray-4.45.2-amd64.deb\n\n首次安装后将显示**随机生成的端口号**和**用户ID（UUID）**，**额外ID（alterId）为0**。若已安装过旧版本，会提示是否替换之前的配置文件，如果选择“N”则不会重新生成端口号和UUID。将上述信息填入手机或PC端的v2ray客户端。\n\n上述配置信息都保存在/etc/v2ray/config.json中（此文件为符号链接，指向同目录下的server.json），安装完成后会自动启动v2ray服务。\n\n您可以在安装完成后通过修改文件/etc/v2ray/config.json来自定义端口号和用户ID等配置信息（UUID的格式和长度是固定的，请不要随意修改）。\n\n修改配置文件后须重启v2ray服务使之生效：\n* sudo systemctl restart v2ray\n\n生成用户ID（UUID）的方法：\n* cat /proc/sys/kernel/random/uuid\n\n你也可以将符号链接文件/etc/v2ray/config.json指向client.json来将其作为客户端使用（默认不能同时作为服务端和客户端）：\n* sudo unlink /etc/v2ray/config.json\n* sudo ln -s /etc/v2ray/client.json /etc/v2ray/config.json\n## 卸载\n您可通过如下命令卸载（保留配置文件和日志）：\n* sudo dpkg -r v2ray\n\n或者\n* sudo apt-get remove v2ray\n\n完全卸载（移除配置文件和日志）：\n* sudo apt-get purge v2ray\n## 自行打包\n您也可以自行打包生成deb安装包（AMD64）：\n* git clone https://github.com/dreamrover/v2ray-deb.git\n* cd v2ray-deb\n* chmod +x build.sh\n* ./build.sh\n\n如果您需要其他CPU平台的deb安装包，请前官网下载对应的二进制压缩包，并替换此项目中usr/bin/v2ray目录下的可执行文件v2ray和v2ctl，然后按照上述命令生成。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdreamrover%2Fv2ray-deb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdreamrover%2Fv2ray-deb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdreamrover%2Fv2ray-deb/lists"}