Welcome to NICK's BLOG!

At Beginning

iiiii This is my first blog !!!!!

搭建梯子

常见梯子协议

“梯子”通常指用于翻墙或代理的工具，其核心依赖各种协议来传输数据。下面我列出一些常见的协议，包括传统VPN协议（如OpenVPN、WireGuard）和代理协议（如Shadowsocks、Trojan，常用于绕过审查）。

我将使用表格形式比较，便于阅读。数据基于常见协议的通用特性。

附加说明

对于翻墙需求，优先考虑Shadowsocks、Trojan或Hysteria，这些协议在绕过GFW方面表现更好。传统VPN如WireGuard适合隐私保护，但可能被封锁。

常见协议搭建

服务器性能优化

优化服务器性能适用于所有代理协议（如 Shadowsocks、Trojan、V2Ray），可提高连接速度、降低延迟并支持更多并发连接。以下是主要优化的用途和原理，以及具体配置步骤。

优化用途和原理

• TCP Fast Open：
  • 用途：减少 TCP 连接建立的往返时间（RTT），提高首次连接速度。
  • 原理：TCP Fast Open 允许在三次握手时携带数据，减少一次往返。这对高延迟网络（如跨国连接）尤为有效，特别适合 TLS 协议（如 Trojan、V2Ray）或频繁建立连接的场景（如 Shadowsocks）。
• 文件描述符限制调整：
  • 用途：增加服务器支持的并发连接数，防止因高负载导致连接失败。
  • 原理：文件描述符是系统分配给网络连接和文件的资源句柄。默认限制较低（通常 1024），可能不足以应对高并发。提高限制（如 51200）允许服务器处理更多同时连接。

优化配置步骤

Red Hat/CentOS

• 开启 TCP Fast Open：

  1	sudo nano /etc/sysctl.d/99-tcp-fastopen.conf

  添加：

  1	net.ipv4.tcp_fastopen = 3

  应用：

  1	sudo sysctl -p /etc/sysctl.d/99-tcp-fastopen.conf

• 调整文件描述符限制：

  1	sudo nano /etc/security/limits.conf

  添加：

  1 2	* soft nofile 51200 * hard nofile 51200

  应用：

  1	ulimit -n 51200

Ubuntu/Debian

• 开启 TCP Fast Open：

  1	sudo nano /etc/sysctl.conf

  添加：

  1	net.ipv4.tcp_fastopen = 3

  应用：

  1	sudo sysctl -p

• 调整文件描述符限制：

  1	sudo nano /etc/security/limits.conf

  添加：

  1 2	* soft nofile 51200 * hard nofile 51200

  应用：

  1	ulimit -n 51200

Shadowsocks

工作原理

Shadowsocks 是一种基于 SOCKS5 的代理协议，通过在客户端和服务器之间建立加密通道传输数据。其核心优势在于轻量高效和伪装能力。客户端将数据加密后发送到服务器，服务器解密后转发到目标网站，返回的数据则反向加密传输。由于其流量可以伪装为常规 SOCKS5 流量，且支持多种加密算法（如 chacha20-ietf-poly1305 和 aes-256-gcm），Shadowsocks 能有效绕过防火墙检测（如 GFW），特别适合翻墙场景。相比传统 VPN，Shadowsocks 更专注于代理而非全面隧道，配置更灵活但不加密整个网络栈。

默认端口

Shadowsocks 默认使用 8388 端口，但可以自定义为任意高位端口（1024-65535）。建议选择随机高位端口以降低被扫描或封锁的风险。配置文件中的 server_port 参数用于设置此端口。

Red Hat/CentOS

环境

• 操作系统：RHEL 8/9 或 CentOS 8/9
• 权限：Root 或 sudo 权限
• 工具：Shadowsocks-libev（推荐，轻量高效）

步骤

1. 更新系统并安装依赖

确保系统软件包是最新的，并安装必要的工具。

1
2
3

sudo dnf update -y
sudo dnf install -y epel-release
sudo dnf install -y curl wget git

2. 安装 Shadowsocks-libev

RHEL/CentOS 不提供官方的 Shadowsocks-libev 包，需通过源码编译安装。

1
2
3
4
5
6
7
8
9
10
11
12

# 安装编译依赖
sudo dnf groupinstall -y "Development Tools"
sudo dnf install -y libev-devel libsodium-devel mbedtls-devel c-ares-devel

# 下载并编译 Shadowsocks-libev
git clone https://github.com/shadowsocks/shadowsocks-libev.git
cd shadowsocks-libev
git submodule update --init
./autogen.sh
./configure
make
sudo make install

3. 配置 Shadowsocks

创建配置文件 /etc/shadowsocks-libev/config.json。

1
2

sudo mkdir -p /etc/shadowsocks-libev
sudo nano /etc/shadowsocks-libev/config.json

粘贴以下配置（根据需要修改）：

1
2
3
4
5
6
7
8
9
10
11

{
    "server":"0.0.0.0",
    "server_port":8388,
    "local_port":1080,
    "password":"your_secure_password",
    "timeout":300,
    "method":"chacha20-ietf-poly1305",
    "fast_open":true,
    "nameserver":"8.8.8.8",
    "mode":"tcp_and_udp"
}

• server：监听地址，0.0.0.0 表示所有接口。
• server_port：服务端口，建议 8388 或随机高位端口（避免被扫描）。
• password：设置强密码，建议 16 位以上随机字符串。
• method：推荐 chacha20-ietf-poly1305 或 aes-256-gcm，安全性高且性能好。
• fast_open：启用 TCP Fast Open，减少连接延迟。
• mode：支持 TCP 和 UDP，适合多种应用。

保存并退出（Ctrl+O, Enter, Ctrl+X）。

4. 创建 systemd 服务

Shadowsocks-libev 需要手动创建 systemd 服务文件以便管理。

1

sudo nano /etc/systemd/system/shadowsocks-libev.service

添加以下内容：

1
2
3
4
5
6
7
8
9
10
11

[Unit]
Description=Shadowsocks-libev Server
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/ss-server -c /etc/shadowsocks-libev/config.json
Restart=on-failure

[Install]
WantedBy=multi-user.target

保存后，启用并启动服务：

1
2
3

sudo systemctl daemon-reload
sudo systemctl start shadowsocks-libev
sudo systemctl enable shadowsocks-libev

检查服务状态：

1

sudo systemctl status shadowsocks-libev

Ubuntu/Debian

环境

• 操作系统：Ubuntu 20.04/22.04 或 Debian 10/11
• 权限：Root 或 sudo 权限
• 工具：Shadowsocks-libev（推荐，轻量高效）

步骤

1. 更新系统并安装依赖

确保系统软件包是最新的，并安装必要的工具。

1
2

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget software-properties-common

2. 安装 Shadowsocks-libev

Ubuntu/Debian 提供官方 PPA，安装更简单。

1
2
3
4
5
6

# 添加 PPA
sudo add-apt-repository ppa:max-c-lv/shadowsocks-libev -y
sudo apt update

# 安装 Shadowsocks-libev
sudo apt install -y shadowsocks-libev

3. 配置 Shadowsocks

创建配置文件 /etc/shadowsocks-libev/config.json。

1
2

sudo mkdir -p /etc/shadowsocks-libev
sudo nano /etc/shadowsocks-libev/config.json

粘贴以下配置（根据需要修改）：

1
2
3
4
5
6
7
8
9
10
11

{
    "server":"0.0.0.0",
    "server_port":8388,
    "local_port":1080,
    "password":"your_secure_password",
    "timeout":300,
    "method":"chacha20-ietf-poly1305",
    "fast_open":true,
    "nameserver":"8.8.8.8",
    "mode":"tcp_and_udp"
}

• server：监听地址，0.0.0.0 表示所有接口。
• server_port：服务端口，建议 8388 或随机高位端口（避免被扫描）。
• password：设置强密码，建议 16 位以上随机字符串。
• method：推荐 chacha20-ietf-poly1305 或 aes-256-gcm，安全性高且性能好。
• fast_open：启用 TCP Fast Open，减少连接延迟。
• mode：支持 TCP 和 UDP，适合多种应用。

保存并退出（Ctrl+O, Enter, Ctrl+X）。

4. 启动 Shadowsocks 服务

Shadowsocks-libev 默认以服务形式运行，配置 systemd 服务。

1
2
3
4
5

# 启动服务
sudo systemctl start shadowsocks-libev

# 设置开机自启
sudo systemctl enable shadowsocks-libev

检查服务状态：

1

sudo systemctl status shadowsocks-libev

Trojan

工作原理

Trojan 是一种基于 HTTPS 的代理协议，设计目标是伪装成常规的 Web 流量以绕过深度包检测（如 GFW）。它利用 TLS/SSL 加密，客户端与服务器之间的通信通过 HTTPS 协议（基于 TCP 443 端口）进行，流量看起来像是普通的 HTTPS 网站访问。Trojan 服务器接收客户端请求后，验证 TLS 证书和密码，解密数据并转发到目标地址。返回的数据同样通过 TLS 加密回传。这种伪装使得 Trojan 在严格审查环境下难以被检测，适合翻墙场景。相比 Shadowsocks，Trojan 的加密更强（依赖 TLS），但需要有效的 SSL 证书。

默认端口

Trojan 默认使用 443 端口，与标准 HTTPS 一致。这使得其流量难以与常规 Web 流量区分，增强了伪装能力。配置文件中的 local_port 参数设置此端口，可根据需要更改，但建议保留 443 以最大化伪装效果。

Red Hat/CentOS

环境

• 操作系统：RHEL 8/9 或 CentOS 8/9
• 权限：Root 或 sudo 权限
• 工具：Trojan（官方实现，轻量高效）

步骤

1. 更新系统并安装依赖

确保系统软件包是最新的，并安装必要的工具。

1
2
3

sudo dnf update -y
sudo dnf install -y epel-release
sudo dnf install -y curl wget git openssl

2. 安装 Trojan

Trojan 需要从源码编译安装。

1
2
3
4
5
6
7
8
9
10

# 安装编译依赖
sudo dnf groupinstall -y "Development Tools"
sudo dnf install -y boost-devel openssl-devel

# 下载并编译 Trojan
git clone https://github.com/trojan-gfw/trojan.git
cd trojan
cmake .
make
sudo make install

3. 获取 SSL 证书

Trojan 需要有效的 SSL/TLS 证书。

使用 Let’s Encrypt 获取免费证书。

1 2	sudo dnf install -y certbot python3-certbot-nginx sudo certbot certonly --standalone -d your_domain.com

证书通常存储在 /etc/letsencrypt/live/your_domain.com/，记录 fullchain.pem 和 privkey.pem 的路径。

4. 配置 Trojan

创建配置文件 /usr/local/etc/trojan/config.json。

1
2

sudo mkdir -p /usr/local/etc/trojan
sudo nano /usr/local/etc/trojan/config.json

添加以下配置（根据需要修改）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

{
    "run_type": "server",
    "local_addr": "0.0.0.0",
    "local_port": 443,
    "remote_addr": "127.0.0.1",
    "remote_port": 80,
    "password": ["your_secure_password"],
    "ssl": {
        "cert": "/etc/letsencrypt/live/your_domain.com/fullchain.pem",
        "key": "/etc/letsencrypt/live/your_domain.com/privkey.pem",
        "cipher": "ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384",
        "prefer_server_cipher": true
    },
    "tcp": {
        "fast_open": true
    }
}

• local_addr：监听所有接口（0.0.0.0）。
• local_port：端口 443，模拟 HTTPS 流量。
• password：强密码，建议 16 位以上。
• cert 和 key：SSL 证书和私钥路径。
• fast_open：启用 TCP Fast Open 降低延迟。

保存并退出（Ctrl+O, Enter, Ctrl+X）。

5. 创建 systemd 服务

创建 systemd 服务文件以管理 Trojan。

1

sudo nano /etc/systemd/system/trojan.service

添加：

1
2
3
4
5
6
7
8
9
10
11

[Unit]
Description=Trojan Server
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/trojan -c /usr/local/etc/trojan/config.json
Restart=on-failure

[Install]
WantedBy=multi-user.target

启用并启动服务：

1
2
3

sudo systemctl daemon-reload
sudo systemctl start trojan
sudo systemctl enable trojan

检查服务状态：

1

sudo systemctl status trojan

Ubuntu/Debian

环境

• 操作系统：Ubuntu 20.04/22.04 或 Debian 10/11
• 权限：Root 或 sudo 权限
• 工具：Trojan（官方实现，轻量高效）

步骤

1. 更新系统并安装依赖

确保系统软件包是最新的，并安装必要的工具。

1
2

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git openssl

2. 安装 Trojan

从源码编译安装 Trojan。

1
2
3
4
5
6
7
8
9

# 安装编译依赖
sudo apt install -y build-essential cmake libboost-all-dev libssl-dev

# 下载并编译 Trojan
git clone https://github.com/trojan-gfw/trojan.git
cd trojan
cmake .
make
sudo make install

3. 获取 SSL 证书

Trojan 需要有效的 SSL/TLS 证书。

使用 Let’s Encrypt 获取免费证书。

1 2	sudo dnf install -y certbot python3-certbot-nginx sudo certbot certonly --standalone -d your_domain.com

证书通常存储在 /etc/letsencrypt/live/your_domain.com/，记录 fullchain.pem 和 privkey.pem 的路径。

4. 配置 Trojan

创建配置文件 /usr/local/etc/trojan/config.json。

1
2

sudo mkdir -p /usr/local/etc/trojan
sudo nano /usr/local/etc/trojan/config.json

添加（根据需要修改）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

{
    "run_type": "server",
    "local_addr": "0.0.0.0",
    "local_port": 443,
    "remote_addr": "127.0.0.1",
    "remote_port": 80,
    "password": ["your_secure_password"],
    "ssl": {
        "cert": "/etc/letsencrypt/live/your_domain.com/fullchain.pem",
        "key": "/etc/letsencrypt/live/your_domain.com/privkey.pem",
        "cipher": "ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384",
        "prefer_server_cipher": true
    },
    "tcp": {
        "fast_open": true
    }
}

保存并退出（Ctrl+O, Enter, Ctrl+X）。

5. 创建 systemd 服务

1

sudo nano /etc/systemd/system/trojan.service

添加：

1
2
3
4
5
6
7
8
9
10
11

[Unit]
Description=Trojan Server
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/trojan -c /usr/local/etc/trojan/config.json
Restart=on-failure

[Install]
WantedBy=multi-user.target

启用并启动：

1
2
3

sudo systemctl daemon-reload
sudo systemctl start trojan
sudo systemctl enable trojan

检查状态：

1

sudo systemctl status trojan

V2Ray (VMess)

工作原理

VMess 是 V2Ray 框架下的核心代理协议，通过加密和多路复用（multiplexing）实现高效、安全的流量传输。客户端与服务器通过加密通道通信，支持动态端口、流量伪装（如 HTTP/HTTPS 或 WebSocket）和多路复用以降低检测风险。VMess 流量可伪装为常规 Web 流量，结合 TLS 或其他传输协议（如 WebSocket），使其在严格审查环境下表现优异。相比 Shadowsocks，VMess 配置更复杂但功能更强大；相比 Trojan，它更灵活但伪装能力稍逊。VMess 适合需要高自定义和复杂路由规则的翻墙场景。

默认端口

VMess 没有固定的默认端口，但通常使用 443（模拟 HTTPS）或 1080（常见代理端口）。建议使用 443 以增强伪装效果，配置文件中的 port 参数用于设置端口。

Red Hat/CentOS

环境

• 操作系统：RHEL 8/9 或 CentOS 8/9
• 权限：Root 或 sudo 权限
• 工具：V2Ray（官方实现，功能强大）

步骤

1. 更新系统并安装依赖

确保系统软件包是最新的，并安装必要的工具。

1
2
3

sudo dnf update -y
sudo dnf install -y epel-release
sudo dnf install -y curl wget git unzip

2. 安装 V2Ray

从官方发布页面下载并安装 V2Ray。

1
2

# 下载最新版 V2Ray
bash <(curl -L https://github.com/v2fly/v2ray-core/releases/latest/download/install-release.sh)

这会将 V2Ray 安装到 /usr/local/bin/v2ray 和配置文件到 /usr/local/etc/v2ray。

3. 获取 SSL 证书

VMess 若使用 TLS 传输（如 HTTPS 伪装）需要 SSL 证书。使用 Let’s Encrypt 获取免费证书。

1
2

sudo dnf install -y certbot python3-certbot-nginx
sudo certbot certonly --standalone -d your_domain.com

证书存储在 /etc/letsencrypt/live/your_domain.com/，记录 fullchain.pem 和 privkey.pem 路径。

4. 配置 V2Ray

创建配置文件 /usr/local/etc/v2ray/config.json。

1
2

sudo mkdir -p /usr/local/etc/v2ray
sudo nano /usr/local/etc/v2ray/config.json

添加以下配置（使用 VMess + TLS，需修改）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

{
    "inbounds": [{
        "port": 443,
        "protocol": "vmess",
        "settings": {
            "clients": [
                {
                    "id": "your_uuid",
                    "alterId": 0
                }
            ]
        },
        "streamSettings": {
            "network": "tcp",
            "security": "tls",
            "tlsSettings": {
                "certificates": [
                    {
                        "certificateFile": "/etc/letsencrypt/live/your_domain.com/fullchain.pem",
                        "keyFile": "/etc/letsencrypt/live/your_domain.com/privkey.pem"
                    }
                ]
            }
        }
    }],
    "outbounds": [{
        "protocol": "freedom",
        "settings": {}
    }]
}

• port：443，模拟 HTTPS 流量。
• id：使用 UUID（运行 v2ray uuid 生成）。
• alterId：建议设为 0（新版 V2Ray 默认）。
• certificateFile 和 keyFile：SSL 证书和私钥路径。
• streamSettings：使用 TLS 传输，伪装 HTTPS。

保存并退出（Ctrl+O, Enter, Ctrl+X）。

5. 创建 systemd 服务

V2Ray 默认提供 systemd 服务，确认配置文件。

1
2

sudo systemctl enable v2ray
sudo systemctl start v2ray

检查服务状态：

1

sudo systemctl status v2ray

Ubuntu/Debian

环境

• 操作系统：Ubuntu 20.04/22.04 或 Debian 10/11
• 权限：Root 或 sudo 权限
• 工具：V2Ray（官方实现，功能强大）

步骤

1. 更新系统并安装依赖

确保系统软件包是最新的，并安装必要的工具。

1
2

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git unzip

2. 安装 V2Ray

使用官方安装脚本。

1

bash <(curl -L https://github.com/v2fly/v2ray-core/releases/latest/download/install-release.sh)

安装路径同 Red Hat/CentOS。

3. 获取 SSL 证书

1
2

sudo apt install -y certbot python3-certbot-nginx
sudo certbot certonly --standalone -d your_domain.com

证书存储在 /etc/letsencrypt/live/your_domain.com/。

4. 配置 V2Ray

创建配置文件 /usr/local/etc/v2ray/config.json。

1
2

sudo mkdir -p /usr/local/etc/v2ray
sudo nano /usr/local/etc/v2ray/config.json

添加（与 Red Hat/CentOS 相同，需修改）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

{
    "inbounds": [{
        "port": 443,
        "protocol": "vmess",
        "settings": {
            "clients": [
                {
                    "id": "your_uuid",
                    "alterId": 0
                }
            ]
        },
        "streamSettings": {
            "network": "tcp",
            "security": "tls",
            "tlsSettings": {
                "certificates": [
                    {
                        "certificateFile": "/etc/letsencrypt/live/your_domain.com/fullchain.pem",
                        "keyFile": "/etc/letsencrypt/live/your_domain.com/privkey.pem"
                    }
                ]
            }
        }
    }],
    "outbounds": [{
        "protocol": "freedom",
        "settings": {}
    }]
}

保存并退出（Ctrl+O, Enter, Ctrl+X）。

5. 创建 systemd 服务

1
2

sudo systemctl enable v2ray
sudo systemctl start v2ray

检查状态：

1

sudo systemctl status v2ray

客户端连接

在客户端（如 Clash Verge、V2Ray 客户端）配置：

• 服务器地址：服务器公网 IP 或域名
• 端口：协议对应端口（如 Shadowsocks 8388、Trojan/V2Ray 443）
• 密码/ID：配置文件中的密码或 UUID
• 协议：Shadowsocks、Trojan 或 VMess
• TLS（Trojan/V2Ray）：启用，需有效证书

Clash Verge 支持： Clash 完全支持 Shadowsocks、Trojan 和 VMess 协议。在 Clash 中，导入以下 YAML 配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

proxies:
  - name: "ss-server"
    type: ss
    server: your_server_ip
    port: 8388
    cipher: chacha20-ietf-poly1305
    password: your_secure_password
    udp: true
  - name: "trojan-server"
    type: trojan
    server: your_domain.com
    port: 443
    password: your_secure_password
    sni: your_domain.com
    skip-cert-verify: false
    udp: true
  - name: "vmess-server"
    type: vmess
    server: your_domain.com
    port: 443
    uuid: your_uuid
    alterId: 0
    cipher: auto
    tls: true
    skip-cert-verify: false
    network: tcp
    udp: true

Clash 客户端配置

Clash（如 Clash Verge）是一个功能强大的代理客户端，支持多种协议（如 Shadowsocks、Trojan、VMess）。以下是你提供的 Clash 配置文件中各部分的作用和推荐配置方式：

配置文件解析

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

port: 7890
allow-lan: true
mode: rule
log-level: info
unified-delay: true
global-client-fingerprint: chrome
dns:
  enable: true
  listen: :53
  ipv6: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  default-nameserver: 
    - 223.5.5.5
    - 8.8.8.8
  nameserver:
    - https://dns.alidns.com/dns-query
    - https://doh.pub/dns-query
  fallback:
    - https://1.0.0.1/dns-query
    - tls://dns.google
  fallback-filter:
    geoip: true
    geoip-code: CN
    ipcidr:
      - 240.0.0.0/4
proxies:
  - name: "ss-server"
    type: ss
    server: your_server_ip
    port: 8388
    cipher: chacha20-ietf-poly1305
    password: your_secure_password
    udp: true
  - name: "trojan-server"
    type: trojan
    server: your_domain.com
    port: 443
    password: your_secure_password
    sni: your_domain.com
    skip-cert-verify: false
    udp: true
  - name: "vmess-server"
    type: vmess
    server: your_domain.com
    port: 443
    uuid: your_uuid
    alterId: 0
    cipher: auto
    tls: true
    skip-cert-verify: false
    network: tcp
    udp: true
proxy-groups:
- name: 负载均衡
  type: load-balance
  url: https://cp.cloudflare.com/generate_204
  interval: 300
  strategy: round-robin
  proxies:
    - ss-server
- name: 自动选择
  type: url-test
  url: https://cp.cloudflare.com/generate_204
  interval: 300
  tolerance: 50
  proxies:
    - ss-server
- name: Nick666
  type: select
  proxies:
    - 负载均衡
    - 自动选择
    - DIRECT
    - ss-server
rules:
  # 规则部分待补充

各部分作用与配置建议：

1. 基本配置：

   • port: 7890
     • 作用：设置 Clash 的 HTTP 代理端口，客户端通过此端口访问代理（如浏览器设置代理为 127.0.0.1:7890）。
     • 推荐配置：默认 7890，需确保本地无其他程序占用。可改为其他端口（如 8080），但需同步更新客户端配置。
   • allow-lan: true
     • 作用：允许局域网设备通过 Clash 代理访问网络（如手机连接电脑的 Clash 代理）。
     • 推荐配置：若仅本地使用，设为 false 以提高安全性；若需局域网共享，设为 true，并确保防火墙允许相关端口（如 7890）。
   • mode: rule
     • 作用：设置代理模式，rule 表示按规则分流（根据 rules 决定哪些流量走代理）。其他选项包括 global（全部走代理）或 direct（全部直连）。
     • 推荐配置：rule 适合国内用户，结合规则实现国内外流量分流；global 适合完全代理场景。
   • log-level: info
     • 作用：设置日志级别，info 显示常规日志信息。其他选项：silent（无日志）、warning、error、debug。
     • 推荐配置：日常使用设为 info；调试时设为 debug；生产环境可设为 warning 或 error 减少日志。
   • unified-delay: true
     • 作用：启用统一延迟测试，规范化不同协议的延迟测量结果。
     • 推荐配置：设为 true，确保延迟测试准确，方便选择最优节点。
   • global-client-fingerprint: chrome
     • 作用：伪装客户端的 TLS 指纹为 Chrome 浏览器，降低被防火墙检测的风险。
     • 推荐配置：设为 chrome 或其他主流浏览器（如 firefox），增强伪装效果。

2. DNS 配置：

   • enable: true
     • 作用：启用 Clash 的 DNS 解析功能，接管系统 DNS 请求。
     • 推荐配置：设为 true，确保 DNS 请求通过代理，防止泄露。
   • listen: :53
     • 作用：Clash 监听本地 53 端口处理 DNS 请求（需 root 权限或重定向）。
     • 推荐配置：保持 :53，但需确保系统防火墙允许 53 端口，或使用高位端口（如 1053）避免冲突。
   • ipv6: true
     • 作用：启用 IPv6 DNS 解析支持。
     • 推荐配置：国内环境建议设为 false（多数网络 IPv6 不稳定）；若网络支持 IPv6，可设为 true。
   • enhanced-mode: fake-ip
     • 作用：使用 Fake IP 模式，将域名解析为虚拟 IP（198.18.0.1/16），通过 Clash 代理解析真实地址，防止 DNS 污染。
     • 推荐配置：fake-ip 适合翻墙场景；若无需防污染，可用 redir-host 模式。
   • fake-ip-range: 198.18.0.1/16
     • 作用：Fake IP 的 IP 范围，Clash 用此范围分配虚拟 IP。
     • 推荐配置：默认 198.18.0.1/16，无需修改，确保不与本地网络冲突。
   • default-nameserver:
     • 作用：用于解析 DNS 配置本身的域名（如 dns.alidns.com）。
     • 配置：223.5.5.5（阿里 DNS）、8.8.8.8（Google DNS），国内建议优先使用国内 DNS。
   • nameserver:
     • 作用：主 DNS 服务器，处理国内域名解析（如 https://dns.alidns.com/dns-query）。
     • 推荐配置：使用 DoH（DNS over HTTPS）服务器，如阿里、腾讯的 DoH，提升安全性。
   • fallback:
     • 作用：备用 DNS 服务器，处理国外域名解析（如 https://1.0.0.1/dns-query、Google DNS）。
     • 推荐配置：使用国外 DoH/TLS 服务器，确保翻墙域名解析正常。
   • fallback-filter:
     • 作用：过滤 DNS 解析结果，决定哪些域名使用 fallback 服务器。
     • geoip: true, geoip-code: CN：国内 IP 地址使用 nameserver 解析。
     • ipcidr: 240.0.0.0/4：指定 IP 范围（如组播地址）走 fallback。
     • 推荐配置：保持 geoip: true 和 geoip-code: CN，确保国内域名走国内 DNS，国外域名走国外 DNS。

3. proxies：

   • 作用：定义代理节点（如 Shadowsocks 节点）。

   • 示例：

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

     proxies: - name: "ss-server" type: ss server: your_server_ip port: 8388 cipher: chacha20-ietf-poly1305 password: your_secure_password udp: true - name: "trojan-server" type: trojan server: your_domain.com port: 443 password: your_secure_password sni: your_domain.com skip-cert-verify: false udp: true - name: "vmess-server" type: vmess server: your_domain.com port: 443 uuid: your_uuid alterId: 0 cipher: auto tls: true skip-cert-verify: false network: tcp udp: true

     • name：节点名称，任意设置，便于识别。
     • type：协议类型。
     • server：服务器 IP 或域名。
     • port：服务器端口，与服务器配置一致。
     • cipher：加密算法，需与服务器一致。
     • password：密码，需与服务器一致。
     • udp：启用 UDP 支持，适合游戏或实时应用。

   • 推荐配置：确保 server、port、cipher 和 password 与服务器配置完全匹配；udp: true 适合需要 UDP 的场景。

4. proxy-groups：

   • 作用：定义代理组，控制节点的选择方式（如手动选择、自动测试、负载均衡）。

   • 示例：

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

     - name: 负载均衡 type: load-balance url: https://cp.cloudflare.com/generate_204 interval: 300 strategy: round-robin proxies: - ss-server - name: 自动选择 type: url-test url: https://cp.cloudflare.com/generate_204 interval: 300 tolerance: 50 proxies: - ss-server - name: Nick666 type: select proxies: - 负载均衡 - 自动选择 - DIRECT - ss-server

     • 负载均衡（type: load-balance）：
       • 作用：将流量平均分配到多个节点，适合高负载场景。
       • url：测试延迟的 URL，https://cp.cloudflare.com/generate_204 是一个快速响应地址。
       • interval：测试间隔（秒），300 表示每 5 分钟测试一次。
       • strategy: round-robin：轮询分配流量，另可选 consistent-hashing。
       • 推荐配置：适合多节点场景，interval 设为 300-600，url 使用可靠测试地址。
     • 自动选择（type: url-test）：
       • 作用：自动选择延迟最低的节点。
       • tolerance：延迟变化容忍度（毫秒），50 表示延迟变化小于 50ms 不切换。
       • 推荐配置：interval 设为 300-600，tolerance 设为 50-100，适合动态选择最优节点。
     • 手动选择（type: select）：
       • 作用：允许用户手动选择代理组或节点（如 负载均衡、自动选择、直接连接或具体节点）。
       • 推荐配置：作为顶层组，包含其他组和 DIRECT，便于灵活切换。

5. rules：

   • 作用：定义流量分流规则，决定哪些流量走代理、哪些直连。

   • 示例（需补充完整规则）：

     1 2 3 4 5

     rules: - DOMAIN-SUFFIX,google.com,自动选择 - DOMAIN-SUFFIX,cn,DIRECT - GEOIP,CN,DIRECT - MATCH,Nick666

     • DOMAIN-SUFFIX：匹配域名后缀（如 google.com 走代理）。
     • GEOIP：匹配 IP 地理位置（如国内 IP 直连）。
     • MATCH：默认规则，匹配未命中规则的流量。
     • 推荐配置：
       • 使用域名规则（如 DOMAIN-SUFFIX）区分国内外流量。
       • 使用 GEOIP,CN,DIRECT 确保国内流量直连。
       • 规则文件可从开源项目（如 Loyalsoldier/clash-rules）导入，减少手动配置。

React

React 简介

• 由 Meta 公司开发，用于构建 Web 和原生交互界面的库
• 优势：
  • 组件化开发方式
  • 高性能
  • 丰富生态
  • 跨平台支持

开发环境创建

使用 create-react-app 快速创建项目：

1

npx create-react-app react-basic

JSX 基础

基本概念

• JSX 是 JavaScript 和 HTML 的混合语法
• 示例：

1
2
3
4
5
6
7
8
9

const message = 'this is message'
function App(){
  return (
    <div>
      <h1>this is title</h1>
      {message}
    </div>
  )
}

表达式使用

• 使用大括号 {} 嵌入 JavaScript 表达式

• 支持变量、函数调用等

  1 2 3 4 5 6 7 8 9 10 11

  function App() { function formatDate() { return new Date().toLocaleDateString() } return ( <div> <p>当前日期: {formatDate()}</p> </div> ) }

列表渲染

使用 map 方法渲染列表：

1
2
3
4
5
6
7
8
9
10
11

const list = [
  {id:1001, name:'Vue'},
  {id:1002, name: 'React'}
]
function App(){
  return (
    <ul>
      {list.map(item=><li key={item.id}>{item.name}</li>)}
    </ul>
  )
}

条件渲染

• 使用 && 运算符

  1 2 3 4 5 6 7 8 9

  function App() { const name = '张三' return ( <div> <p>用户名: {name}</p> </div> ) }

• 使用三元表达式 ?:

  1 2 3 4 5 6 7 8 9 10 11 12 13

  function App() { const isLoading = true return ( <div> {isLoading ? ( <span>加载中...</span> ) : ( <span>内容加载完成</span> )} </div> ) }

• 复杂条件渲染

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

  function App() { const status = 2 // 0|1|2 const renderContent = () => { if (status === 0) { return <div>状态0的内容</div> } else if (status === 1) { return <div>状态1的内容</div> } else { return <div>默认内容</div> } } return ( <div> {renderContent()} </div> ) }

JSX 表达式使用详解

基本语法

在 JSX 中，使用 {} 包裹 JavaScript 表达式：

1
2

const name = '李四';
const element = <h1>你好, {name}</h1>;

变量渲染

1
2
3
4

function Greeting() {
  const username = '张三';
  return <p>欢迎回来, {username}!</p>;
}

函数调用

1
2
3
4
5
6

function formatName(user) {
  return `${user.firstName} ${user.lastName}`;
}

const user = { firstName: '张', lastName: '三丰' };
const element = <h2>你好, {formatName(user)}!</h2>;

运算表达式

1
2
3
4
5
6
7
8
9
10
11

function Calculator() {
  const a = 10;
  const b = 5;
  return (
    <div>
      <p>加法: {a + b}</p>
      <p>乘法: {a * b}</p>
      <p>比较: {a > b ? 'a更大' : 'b更大'}</p>
    </div>
  );
}

对象属性访问

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

const product = {
  name: 'iPhone',
  price: 5999,
  specs: {
    color: '黑色',
    storage: '128GB'
  }
};

function ProductInfo() {
  return (
    <div>
      <p>名称: {product.name}</p>
      <p>价格: ¥{product.price}</p>
      <p>颜色: {product.specs.color}</p>
    </div>
  );
}

数组方法

1
2
3
4
5
6
7
8
9
10
11

const numbers = [1, 2, 3, 4, 5];

function NumberList() {
  return (
    <ul>
      {numbers.map((num) => (
        <li key={num}>数字: {num}</li>
      ))}
    </ul>
  );
}

Lodash 工具库

简介

Lodash 是一个流行的 JavaScript 实用工具库，提供了许多高效、可靠的函数，可以简化数组、对象、字符串等数据类型的操作。

安装

1

npm install lodash

常用方法示例

1. 数组操作

1
2
3
4
5
6
7
8

import _ from 'lodash';

// 数组去重
const arr = [1, 2, 2, 3];
const uniqueArr = _.uniq(arr); // [1, 2, 3]

// 数组分块
const chunked = _.chunk(['a', 'b', 'c', 'd'], 2); // [['a', 'b'], ['c', 'd']]

2. 对象操作

1
2
3
4
5
6

// 深拷贝对象
const obj = { a: 1, b: { c: 2 } };
const cloned = _.cloneDeep(obj);

// 合并对象
const merged = _.merge({ a: 1 }, { b: 2 }); // { a: 1, b: 2 }

3. 字符串处理

1
2
3

// 转换字符串格式
_.camelCase('Foo Bar'); // 'fooBar'
_.kebabCase('FooBar'); // 'foo-bar'

4. 实用函数

1
2
3
4
5
6
7
8
9

// 防抖函数
const debouncedFn = _.debounce(() => {
  console.log('Resized');
}, 200);

// 节流函数
const throttledFn = _.throttle(() => {
  console.log('Scrolled');
}, 100);

事件绑定

基本语法

1
2
3
4
5
6

function App(){
  const clickHandler = ()=>{
    console.log('button clicked')
  }
  return <button onClick={clickHandler}>click me</button>
}

事件参数

1
2
3

const clickHandler = (e)=>{
  console.log('event', e)
}

自定义参数

1

<button onClick={()=>clickHandler('jack')}>click me</button>

组件基础

组件定义

1
2
3
4
5
6
7
8
9
10

function Button(){
  return <button>click me</button>
}
function App(){
  return (
    <div>
      <Button/>
    </div>
  )
}

状态管理 useState

基本使用

1
2
3
4
5
6
7
8

function App(){
  const [count, setCount] = useState(0)
  return (
    <button onClick={()=>setCount(count+1)}>
      {count}
    </button>
  )
}

状态修改规则

• 状态是只读的，必须通过 set 方法更新
• 对象类型状态需要提供全新对象

样式处理

行内样式

1

<div style={{ color:'red' }}>text</div>

这个实际上是react语法的大括号里面套了一个对象

CSS 类名

1
2
3
4

import './index.css'
function App(){
  return <span className="foo">text</span>
}

表单控制

受控绑定

表单元素的值完全由React状态控制，每次输入都会触发状态更新，实现数据与UI的同步绑定。

1
2
3
4
5
6
7
8
9
10

function App() {
  const [value, setValue] = useState('');
  return (
    <input 
      type="text" 
      value={value}
      onChange={(e) => setValue(e.target.value)}
    />
  );
}

非受控绑定

通过ref直接操作DOM获取表单值，React不直接管理输入过程，适合简单场景或集成第三方库。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

function App() {
  const inputRef = useRef(null);
  
  const onChange = () => {
    console.log(inputRef.current.value);
  };
  
  return (
    <input 
      type="text" 
      ref={inputRef}
      onChange={onChange}
    />
  );
}

组件通信

父子通信（父传子）

通过props将父组件数据传递给子组件。

1
2
3
4
5
6
7
8

function Son(props) {
  return <div>{props.name}</div>;
}

function App() {
  const name = 'App数据';
  return <Son name={name} />;
}

父子通信（子传父）

父组件传递回调函数给子组件，子组件调用该函数传回数据。

1
2
3
4
5
6
7
8
9

function Son({ onGetMsg }) {
  const sonMsg = '子组件数据';
  return <button onClick={() => onGetMsg(sonMsg)}>发送</button>;
}

function App() {
  const getMsg = (msg) => console.log(msg);
  return <Son onGetMsg={getMsg} />;
}

兄弟组件通信

通过状态提升，将共享状态放在共同的父组件中管理。

1
2
3
4
5
6
7
8
9

function App() {
  const [name, setName] = useState('');
  return (
    <>
      <A onGetAName={setName} />
      <B name={name} />
    </>
  );
}

跨层组件通信

使用Context API实现跨层级数据传递。

1
2
3
4
5
6
7
8
9
10
11
12
13
14

const MsgContext = createContext();

function B() {
  const msg = useContext(MsgContext);
  return <div>{msg}</div>;
}

function App() {
  return (
    <MsgContext.Provider value="跨层数据">
      <A />
    </MsgContext.Provider>
  );
}

副作用管理

什么是副作用

副作用是指组件渲染过程中与外部系统的交互操作，这些操作可能会影响其他组件或产生外部可观察的变化。

React组件的主要工作是渲染UI，但有时需要执行数据获取、订阅事件、手动修改DOM等”副作用”操作。

何时需要考虑副作用

在以下场景中需要使用useEffect处理副作用：

1. 数据获取：组件加载后从API获取数据
2. 事件订阅：添加/移除事件监听器
3. DOM操作：手动修改DOM元素
4. 定时器：设置/清除定时器
5. 第三方库集成：初始化非React库

基础使用

1
2
3
4
5

useEffect(() => {
  // 执行副作用操作
  //像获取界面数据这种往往只需要在组件挂载的时候执行一次，不需要每次渲染都执行
  fetchData();
}, [dependencies]); // 依赖项数组

清除副作用

1
2
3
4

useEffect(() => {
  const timer = setInterval(() => {}, 1000);
  return () => clearInterval(timer); // 清理函数
}, []);

依赖项详解

依赖项数组决定了副作用函数何时重新执行：

1. 无依赖数组：

   1 2 3

   useEffect(() => { // 每次组件渲染后都会执行 });

2. 空依赖数组：

   1 2 3

   useEffect(() => { // 仅在组件挂载时执行一次 }, []);

3. 有依赖项：

   1 2 3 4

   useEffect(() => { // 在组件挂载时执行 // 当依赖项的值变化时重新执行 }, [count, name]); // 依赖 count 和 name 的变化

自定义Hook

封装可复用的逻辑，必须以use开头命名。

1
2
3
4
5
6

//这里分装了一个只会true false变换的变量
function useToggle(initialValue) {
  const [value, setValue] = useState(initialValue);
  const toggle = () => setValue(!value);
  return [value, toggle];
}

Hooks使用规则

1. 只能在函数组件或自定义Hook的顶层调用
2. 不可在循环、条件判断或嵌套函数中调用Hook

1
2
3
4

// 错误示例
if (condition) {
  useEffect(() => {});
}

Redux 状态管理

Redux 介绍

Redux 是 React 最常用的集中状态管理工具，类似于 Vue 中的 Pinia/Vuex，可以独立于框架运行。它的主要作用是通过集中管理的方式管理应用的状态。

Redux 核心概念

数据流架构

Redux 的数据修改遵循严格的单向数据流规则：

1. State：一个对象，存放管理的数据
2. Action：一个对象，描述如何修改数据
3. Reducer：一个函数，根据 action 的描述更新 state

基本使用流程

1. 定义 reducer 函数
2. 使用 createStore 生成 store 实例
3. 使用 store.subscribe 订阅数据变化
4. 使用 store.dispatch 提交 action
5. 使用 store.getState 获取最新状态

Redux 与 React 集成

环境配置

React官方要求安装Redux Toolkit和react-redux插件

前者是工具集合简化书写，后者用来链接react组件和redux

1

npm install @reduxjs/toolkit react-redux

Store 结构设计

index.js负责组合modules里的所有子模块，并导出store

1
2
3
4
5

/store
  /modules
    counterStore.js
    userStore.js
  index.js

创建 Store

1
2
3
4
5
6
7
8

import { configureStore } from '@reduxjs/toolkit'
import counterReducer from './modules/counterStore'

export default configureStore({
  reducer: {
    counter: counterReducer
  }
})

注入 React 应用

1
2
3
4
5
6
7
8

import { Provider } from 'react-redux'
import store from './store'

ReactDOM.createRoot(document.getElementById('root')).render(
  <Provider store={store}>
    <App />
  </Provider>
)

Redux Toolkit 使用

创建 Slice

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

import { createSlice } from '@reduxjs/toolkit'

const counterSlice = createSlice({
  name: 'counter',
  initialState: { count: 0 },
  reducers: {
    increment(state) {
      state.count++
    },
    decrement(state) {
      state.count--
    }
  }
})

export const { increment, decrement } = counterSlice.actions
export default counterSlice.reducer

组件中使用

1
2
3
4
5
6
7
8
9
10
11
12
13
14

import { useSelector, useDispatch } from 'react-redux'
import { increment } from '../store/modules/counterStore'

function Counter() {
  const count = useSelector(state => state.counter.count)
  const dispatch = useDispatch()

  return (
    <div>
      <button onClick={() => dispatch(increment())}>+</button>
      <span>{count}</span>
    </div>
  )
}

高级用法

异步 Action

1
2
3
4
5
6

const fetchUserData = () => {
  return async (dispatch) => {
    const res = await axios.get('/api/user')
    dispatch(setUserData(res.data))
  }
}

1
2
3
4

const dispatch = useDispatch()
useEffect(()=>{
	dispatch(fetchUserData())
},[dispatch])

Action 传参

1
2
3
4
5

reducers: {
  addToCount(state, action) {
    state.count += action.payload
  }
}

1
2

// 组件中使用
dispatch(addToCount(10))

调试工具

Redux DevTools 提供了强大的调试功能，可以实时查看 state 变化和 action 提交记录。

React Router

前端路由实现了不同URL路径显示不同组件的功能，所有的页面跳转都在浏览器端完成，无需向服务器请求完整页面。

环境搭建

1

npm install react-router-dom

路由模块化

将路由配置单独抽离为模块，保持项目结构清晰

推荐目录结构：

1
2
3
4
5
6

/src
  /pages
    Home.jsx
    About.jsx
  /router
    index.js

路由导航

声明式导航

使用<Link>组件实现导航，类似HTML的<a>标签但不会刷新页面

1
2

<Link to="/about">关于我们</Link>
<Link to={`/user/${userId}`}>用户详情</Link>  // 动态路径

编程式导航

通过useNavigatehook在代码中控制跳转，适合表单提交后等场景

1
2
3
4
5
6
7

const navigate = useNavigate();

function handleLogin() {
  //...登录逻辑
  navigate('/dashboard'); // 跳转
  navigate(-1); // 返回上一页
}

路由传参

1. searchParams

参数会显示在URL中，适合传递筛选条件等简单参数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

// 传参代码
import { useNavigate } from 'react-router-dom';

function FilterComponent() {
  const navigate = useNavigate();
  
  const applyFilters = () => {
    // 传递多个参数
    navigate('/products?category=electronics&price=100-500&sort=desc');
  };

  return <button onClick={applyFilters}>应用筛选</button>;
}

// 取参代码
import { useSearchParams } from 'react-router-dom';

function ProductList() {
  const [searchParams] = useSearchParams();
  
  // 获取单个参数
  const category = searchParams.get('category');
  
  // 获取所有参数
  const params = Object.fromEntries(searchParams.entries());
  
  return (
    <div>
      当前筛选: {category} <br />
      全部参数: {JSON.stringify(params)}
    </div>
  );
}

2. params

参数会成为URL路径的一部分，适合传递资源ID等必要参数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

// 路由配置中需要定义参数占位符
const router = createBrowserRouter([
  {
    path: '/user/:userId',
    element: <UserDetail />
  }
]);

// 传参代码
function UserList() {
  const navigate = useNavigate();
  
  const viewUser = (id) => {
    navigate(`/user/${id}`);  // 参数直接拼接到路径中
  };

  return (
    <button onClick={() => viewUser(123)}>
      查看用户123
    </button>
  );
}

// 取参代码
import { useParams } from 'react-router-dom';

function UserDetail() {
  const { userId } = useParams();  // 获取路由参数
  
  return <div>用户ID: {userId}</div>;
}

3. state

参数不会显示在URL中，适合传递敏感数据或复杂对象

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

// 传参代码
function LoginForm() {
  const navigate = useNavigate();
  
  const handleLogin = () => {
    const userData = {
      id: 123,
      name: '张三',
      token: 'abc123xyz'
    };
    
    navigate('/dashboard', { 
      state: { 
        user: userData,
        loginTime: new Date() 
      } 
    });
  };

  return <button onClick={handleLogin}>登录</button>;
}

// 取参代码
import { useLocation } from 'react-router-dom';

function Dashboard() {
  const { state } = useLocation();
  
  return (
    <div>
      欢迎, {state?.user?.name} <br />
      登录时间: {state?.loginTime?.toLocaleString()}
    </div>
  );
}

嵌套路由

配置方法

通过children属性定义嵌套关系，Outlet作为子路由的渲染出口

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

const router = createBrowserRouter([
  {
    path: '/',
    element: <Layout />,
    children: [
      { index: true, element: <Home /> },  // 默认二级路由
      { path: 'profile', element: <Profile /> }
    ]
  }
])

function Layout() {
  return (
    <div>
      <Header />
      <Outlet />  {/* 子路由渲染位置 */}
      <Footer />
    </div>
  )
}

高级配置

404路由

1
2
3
4

{
  path: '*',
  element: <NotFoundPage />
}

路由模式

1. History 模式 (createBrowserRouter)

特点与配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14

// 创建方式
import { createBrowserRouter } from 'react-router-dom';

const router = createBrowserRouter([
  // 路由配置
]);

// 服务器配置示例（以Nginx为例）
server {
  listen 80;
  location / {
    try_files $uri $uri/ /index.html;
  }
}

优势：

• URL更简洁美观（无#号）
• 符合标准URL规范
• 支持HTML5 History API

注意事项：

1. 服务器配置要求：

   • 所有路径请求都应返回index.html
   • 需要配置URL重写规则

2. 常见服务器配置：

   1 2 3 4 5 6

   # Nginx生产配置 location / { root /usr/share/nginx/html; index index.html; try_files $uri $uri/ /index.html; }

3. 适用场景：

   • 生产环境
   • 需要SEO友好的项目
   • 需要干净URL的项目

4. Hash 模式 (createHashRouter)

特点与配置

1
2
3
4
5
6

// 创建方式
import { createHashRouter } from 'react-router-dom';

const router = createHashRouter([
  // 路由配置
]);

优势：

• 无需服务器特殊配置
• 兼容性极佳（支持IE9+）
• 适合静态文件服务器

特点：

1. URL格式：

   1 2	http://example.com/#/path http://example.com/#/user/123

2. 工作原理：

   • 使用URL hash部分（#后的内容）实现路由
   • 改变hash不会触发页面刷新
   • 监听hashchange事件实现路由切换

3. 适用场景：

   • 静态网站托管（GitHub Pages等）
   • 旧版浏览器支持
   • 快速原型开发
   • 无服务器配置权限的情况

生产境建议

1. 首选History模式：

   • 配置服务器支持URL重写
   • 提供更专业的用户体验

2. Hash模式备用方案：

   • 当无法控制服务器配置时使用

   • 添加兼容性提示：

     1 2 3 4

     // 检测浏览器兼容性 if (!window.history.pushState) { alert('建议使用现代浏览器获得更好体验'); }

3. 混合模式策略：

   1 2 3 4 5 6 7

   // 根据环境自动选择路由模式 const isProduction = process.env.NODE_ENV === 'production'; const createRouter = isProduction ? createBrowserRouter : createHashRouter; const router = createRouter([ // 路由配置 ]);

React + TypeScript

项目初始化与配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 使用 npm
npm create vite@latest react-jike -- --template react-ts

# 或者使用 yarn
yarn create vite react-jike --template react-ts

# 进入项目目录
cd react-jike

# 安装依赖
npm install

# 启动项目
npm run dev

目录结构

1
2
3
4
5
6
7
8
9
10

-src
  -apis           # 项目接口函数
  -assets         # 项目资源文件，如图片等
  -components     # 通用组件
  -pages          # 页面组件
  -store          # 集中状态管理
  -utils          # 工具，如token、axios封装等
  -App.tsx        # 根组件
  -main.tsx       # 项目入口
  -vite-env.d.ts  # 类型声明文件

状态管理最佳实践

useState 类型安全用法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

// 基础类型 - 依赖类型推断
const [count, setCount] = useState(0); // 自动推断为number

// 对象类型 - 显式声明
interface User {
  id: string;
  name: string;
  email?: string; // 可选属性
}

const [user, setUser] = useState<User>({
  id: '1',
  name: 'John'
});

// 可能为null的情况
const [currentUser, setCurrentUser] = useState<User | null>(null);

useRef 类型安全用法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

// DOM引用
const inputRef = useRef<HTMLInputElement>(null);

useEffect(() => {
  inputRef.current?.focus(); // 安全访问
}, []);

// 可变值容器
const timerRef = useRef<number | null>(null);

useEffect(() => {
  timerRef.current = window.setTimeout(() => {
    // ...
  }, 1000);
  
  return () => {
    if (timerRef.current) clearTimeout(timerRef.current);
  };
}, []);

配置路径别名

修改 vite.config.ts

1
2
3
4
5
6
7
8
9
10
11
12

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import path from 'path'

export default defineConfig({
  plugins: [react()],
  resolve: {
    alias: {
      '@': path.resolve(__dirname, './src')
    }
  }
})

创建 tsconfig.json配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

{
  "compilerOptions": {
    "target": "ESNext",
    "useDefineForClassFields": true,
    "lib": ["DOM", "DOM.Iterable", "ESNext"],
    "allowJs": false,
    "skipLibCheck": true,
    "esModuleInterop": false,
    "allowSyntheticDefaultImports": true,
    "strict": true,
    "forceConsistentCasingInFileNames": true,
    "module": "ESNext",
    "moduleResolution": "Node",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "noEmit": true,
    "jsx": "react-jsx",
    "baseUrl": "./",
    "paths": {
      "@/*": ["src/*"]
    }
  },
  "include": ["src"],
  "references": [{ "path": "./tsconfig.node.json" }]
}