V2Ray

https://www.v2fly.org/guide/
Admin
V2Ray is a platform for building proxies to bypass network restrictions, offering flexible...
Tokens:5,050
Snippets:19
Trust Score:9.5
Update:1 year ago
Show doc for...
Tokens:
Raw
### Install V2Ray via Scoop (Windows)

Source: https://www.v2fly.org/guide/install

This command installs V2Ray using the Scoop package manager on Windows. Scoop simplifies the installation and management of command-line tools. Ensure Scoop is installed before running this command.

```powershell
scoop install v2ray
```

--------------------------------

### Verify V2Ray Installation Package

Source: https://www.v2fly.org/guide/install

This command verifies the integrity of a downloaded V2Ray installation package using its signature file. Ensure you have the correct path to the downloaded zip file and its corresponding signature file.

```bash
v2ray verify --sig=Release /path/to/your/downloaded/v2ray/zip/file
```

--------------------------------

### Install V2Ray via Homebrew (macOS)

Source: https://www.v2fly.org/guide/install

This command installs V2Ray using the Homebrew package manager on macOS. Homebrew is a popular package manager for macOS. Ensure Homebrew is installed before executing this command.

```bash
brew install v2ray
```

--------------------------------

### APT Pinning Configuration for Debian Unstable Packages

Source: https://www.v2fly.org/guide/install

This configuration allows installing V2Ray from Debian's unstable repository while keeping the rest of the system on the stable release. It involves modifying APT preferences to prioritize specific releases for packages. After applying these settings, update the package list and install V2Ray.

```bash
# apt edit-sources unstable

deb https://deb.debian.org/debian/ sid main
deb-src https://deb.debian.org/debian/ sid main
```

```text
Package: *
Pin: release a=stable
Pin-Priority: 900

Package: *
Pin: release o=Debian
Pin-Priority: -10

Package: v2ray
Pin: release a=unstable
Pin-Priority: 900
```

```bash
# apt update
# apt install v2ray
```

--------------------------------

### V2Ctl Api Command Example

Source: https://www.v2fly.org/guide/command

This example demonstrates how to use the 'api' subcommand of V2Ctl to call a remote control instruction on a V2Ray process. It specifies the server address and the service method to invoke.

```bash
v2ctl api [--server=127.0.0.1:8080] <Service.Method> <Request>
```

```bash
v2ctl api --server=127.0.0.1:8080 LoggerService.RestartLogger ''
```

--------------------------------

### V2Ray Command Line Arguments

Source: https://www.v2fly.org/guide/command

This snippet shows the basic command-line arguments for running the V2Ray executable. It includes options for checking the version, testing configuration validity, specifying a configuration file, and setting the configuration format.

```bash
v2ray [-version] [-test] [-config=config.json] [-format=json]
```

--------------------------------

### V2Ctl Fetch Command Usage

Source: https://www.v2fly.org/guide/command

This example shows the usage of the 'fetch' subcommand in V2Ctl, which is used to download content from a specified URL. It supports HTTP and HTTPS protocols.

```bash
v2ctl fetch <url>
```

--------------------------------

### V2Ctl Verify Command Usage

Source: https://www.v2fly.org/guide/command

This example demonstrates the 'verify' subcommand of V2Ctl, used for verifying the official signature of a file. It includes options for specifying the signature file path.

```bash
v2ctl verify [--sig=/path/to/sigfile] <filepath>
```

--------------------------------

### Test V2Ray Configuration

Source: https://www.v2fly.org/guide/faq

This command tests the V2Ray configuration file for syntax errors and provides feedback. It requires the path to the configuration file and is a crucial step before running V2Ray.

```bash
v2ray -config=<config-file> -test
```

--------------------------------

### V2Ctl Command Line Structure

Source: https://www.v2fly.org/guide/command

This snippet illustrates the general structure for invoking V2Ctl commands. V2Ctl is a utility tool with various subcommands to manage V2Ray instances and related tasks.

```bash
v2ctl <command> <options>
```

--------------------------------

### Configure V2Ray Service Logging Directory (Linux)

Source: https://www.v2fly.org/guide/install

This command allows you to configure the V2Ray systemd service to write logs to a specific directory. It's necessary if the default log directory requires specific permissions or if you wish to customize log file locations. This uses `systemctl edit` to add a `LogsDirectory` directive to the service file.

```bash
# systemctl edit v2ray.service

[Service]
LogsDirectory=v2ray
```

--------------------------------

### View V2Ray Logs on Linux with systemd

Source: https://www.v2fly.org/guide/faq

This command allows users to view the systemd journal for V2Ray to inspect exit logs on Linux systems. It is useful for diagnosing crashes or unexpected behavior.

```bash
journalctl -u v2ray
```

--------------------------------

### V2Ctl UUID Command

Source: https://www.v2fly.org/guide/command

This snippet shows the simplest V2Ctl command, 'uuid', which generates and outputs a new random UUID upon each execution. It requires no additional arguments.

```bash
v2ctl uuid
```

--------------------------------

### V2Ctl TlsPing Command Usage

Source: https://www.v2fly.org/guide/command

This snippet illustrates how to use the 'tlsping' command in V2Ctl to perform a TLS handshake with a target domain. It allows specifying the IP address of the domain.

```bash
v2ctl tlsping <domain> --ip=[ip]
```

--------------------------------

### V2Ctl Cert Command Options

Source: https://www.v2fly.org/guide/command

This snippet outlines the various options available for the 'cert' subcommand of V2Ctl, used for generating TLS certificates. Options include specifying CA certificate generation, domain names, expiration time, and output formats.

```bash
v2ctl cert [--ca] [--domain=v2ray.com] [--expire=240h] [--name="V2Ray Inc"] [--org="V2Ray Inc] [--json] [--file=v2ray]
```

--------------------------------

### PGP Public Key Block for V2Fly Developers

Source: https://www.v2fly.org/guide/help

This is the PGP public key block for V2Fly developers. It can be used to verify the authenticity of signed messages or to encrypt messages intended for the development team. Import this key to establish secure communication channels.

```text
pub   rsa4096 2020-06-02 [SC] [有效至：2022-01-02]
      E2E35E27914FB007C0D4B6DDB117BA3BE8B494A7
uid           [ 绝对 ] V2Fly Developers <dev@v2fly.org>
sub   rsa4096 2020-06-02 [E] [有效至：2022-01-02]
sub   rsa4096 2020-11-08 [S] [有效至：2022-01-02] // 用于 Debian / Ubuntu 签名


-----BEGIN PGP PUBLIC KEY BLOCK-----

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
M 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

```

--------------------------------

### V2Ray 客户端配置

Source: https://www.v2fly.org/guide/start

这是 V2Ray 客户端的 JSON 配置文件。它设置了一个 SOCKS 代理入站，并将所有非局域网流量通过 vmess 协议转发到指定的服务器。请务必修改 'address' 为你的服务器 IP 或域名。

```json
{
    "inbounds": [
        {
            "port": 1080, 
            "listen": "127.0.0.1",
            "protocol": "socks",
            "settings": {
                "udp": true
            }
        }
    ],
    "outbounds": [
        {
            "protocol": "vmess",
            "settings": {
                "vnext": [
                    {
                        "address": "server", 
                        "port": 10086, 
                        "users": [
                            {
                                "id": "b831381d-6324-4d53-ad4f-8cda48b30811"
                            }
                        ]
                    }
                ]
            }
        },
        {
            "protocol": "freedom",
            "tag": "direct"
        }
    ],
    "routing": {
        "domainStrategy": "IPOnDemand",
        "rules": [
            {
                "type": "field",
                "ip": [
                    "geoip:private"
                ],
                "outboundTag": "direct"
            }
        ]
    }
}
```

--------------------------------

### V2Ray 服务器端配置

Source: https://www.v2fly.org/guide/start

这是 V2Ray 服务器端的 JSON 配置文件。它定义了入站协议（vmess）和监听端口，以及客户端的连接信息。确保 'id' 和端口与客户端配置一致。

```json
{
    "inbounds": [
        {
            "port": 10086, 
            "protocol": "vmess",
            "settings": {
                "clients": [
                    {
                        "id": "b831381d-6324-4d53-ad4f-8cda48b30811"
                    }
                ]
            }
        }
    ],
    "outbounds": [
        {
            "protocol": "freedom"
        }
    ]
}
```
Tokens:
Raw