LMYZPROXY

我们使用了ZBProxy作为Minecraft代理工具。

部署教程

1、加速ip的部署

搭建准备:

(1) 一台入口云服务器 。可以选择美国西海岸、芝加哥、香港或日本的服务器。最好使用CN2 GIA线路（电信）、CMIN2线路（移动）、AS9929线路（联通），确保双程都走的是高质量线路，且出海线路质量也足够高（如果选用美国服务器则不用担心）。使用其他线路均有晚高峰延迟显著增加和严重丢包的风险。

(2) 如果你想要使用Linode: 一个Linode账号，需要有至少5USD余额，如果没有，请去Linode注册，绑定银行卡或PayPal，并充值5USD。

如果你想要使用AWS: 前往AWS注册账号。AWS有免费额度，您不必立即充值。

(3) 一个域名(可选) ，使用域名可以让Minecraft多人游戏列表的ping和连接速度变快，且后面的网页控制可以配置SSL证书。

搭建教程:

(1)通过SSH连接到你的入口云服务器，确保UFW防火墙（如果启用）的30001-30010端口开放。

(2)克隆仓库:

git clone https://github.com/lmyzzzz/lmyzproxy.git
cd lmyzproxy

(3)进入hypixel-proxy目录并创建一个Python虚拟环境。

sudo apt install python3-venv
cd hypixel-proxy
python3 -m venv venv
source venv/bin/activate

(4)安装所需的库

pip install boto3 linode_api4 paramiko requests psutil

(5) 如果你只想使用AWS，不配置Linode，请跳过这里的(5)-(6)步骤。 登录你的Linode账号，前往Linode API Tokens页面，点击Create A Personal Access Token按钮，自行填写Label和Expiry。在Access表格中，找到Select All这一行，勾选Read/Write，然后点击Create Token。妥善保管你的Token。

(6)配置proxy.py和linode_api_handler.py

sudo vim proxy.py
sudo vim linode_api_handler.py

找到开头的这几行内容：

#proxy.py
LINODE_TOKEN = ''
REGION = 'us-ord'
INSTANCE_TYPE = 'g6-nanode-1'
IMAGE = 'linode/ubuntu24.04'
ROOT_PASS = '' 
ZBPROXY_BINARY_PATH = './ZBProxy-linux-amd64-v1'
CONFIG_DIR = './zbproxy_configs' 
HYPIXEL_HOST = 'mc.hypixel.net'
HYPIXEL_PORT = 25565
START_PORT = 30001
LABEL_PREFIX = 'hypixel-proxy-'
SELF_REGION = "REGION"

#linode_api_handler.py
LINODE_TOKEN = ''
LABEL_PREFIX = 'hypixel-proxy-'

将LINODE_TOKEN改为你刚刚创建的Linode API Token。

将ROOT_PASS改为一个强密码。

将SELF_REGION改为你这台服务器的地区+线路，方便你自己辨识。

如果你准备部署多个入口服务器，可以编辑backup_entrance_manager.py，找到

BACKUP_ENTRY_IP = []
BACKUP_ENTRY_ROOT_PASS = []
BACKUP_ENTRY_REGION = []

在BACKUP_ENTRY_IP中，填写你所有其他入口服务器的公网IP地址。

在BACKUP_ENTRY_ROOT_PASS中，填写你所有其他入口服务器的root密码。

在BACKUP_ENTRY_REGION中，填写你所有其他入口服务器的地区和线路，方便你自己辨识。

其他设置保持默认即可。

(7) 如果你只想使用Linode，不配置AWS，请跳过这里的(7)-(11)步骤。 登录AWS账号，把操作区域设置为us-east-2。然后前往AWS IAM控制面板。在左侧导航栏中找到策略，点击新建策略，然后找到策略中定义的权限，选择json格式并编辑，然后把以下内容粘贴进去:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "EC2ProxyScriptCorePermissions",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeImages",
                "ec2:DescribeInstances",
                "ec2:RunInstances",
                "ec2:TerminateInstances",
                "ec2:CreateTags",
                "ec2:DescribeInstanceTypeOfferings",
                "ec2:DescribeInstanceStatus"
            ],
            "Resource": "*"
        }
    ]
}

(8)找到用户，根据指引新建一个IAM用户。把用户的策略设为你在第(7)步中创建的策略。创建完后，在用户列表中点击你刚刚创建的用户，然后找到安全凭证-访问密钥，点击创建访问密钥，在“访问密钥最佳实践和替代方案”页面，选择命令行界面 (CLI)。妥善保管你创建的访问密钥的Access Key ID和Secret Access Key。

(9)安装并配置AWS CLI。在您的入口服务器中执行:

sudo apt update
sudo apt install curl unzip -y
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

安装完成后可通过执行aws --version来验证安装是否成功。然后，在终端中执行aws configure。

接下来，系统会提示您输入四项信息：

AWS Access Key ID [None]: 粘贴你的 Access Key ID，然后按 Enter。

AWS Secret Access Key [None]: 粘贴你的 Secret Access Key，然后按 Enter。

Default region name [None]: 输入 us-east-2，按 Enter。

Default output format [None]: 输入 json，按 Enter。

至此，AWS CLI已经配置完成，boto3库会自动使用刚刚配置好的Access Key，无需再次在python脚本中手动配置。

(10)获取用于连接到AWS EC2实例的SSH密钥对。前往AWS EC2控制面板，然后点击左侧导航栏中的密钥对，点击创建密钥对。输入一个密钥对名称，比如hypixel-proxy-east-2，需要确保和proxyaws.py中的配置相同。密钥对类型选择RSA，私钥文件格式选择.pem。点击创建密钥对，然后将下载好的密钥文件放在和proxyaws.py相同的目录下。

(11)前往AWS EC2安全组，找到安全组名称为default的安全组。点击并编辑入站和出站规则，允许所有TCP IPv4和ICMP IPv4，然后保存更改。如果你不需要配置备用的入口服务器或更改实例规格、密钥名称等，你无需更改proxyaws.py。

(12)此时加速ip应该已经可用了。在终端中运行以下命令进行测试：

python3 proxy.py multicreate 30001
#或者 python3 proxyaws.py multicreate 30001

观察输出，如果没有任何报错、显示代理创建成功，就在Minecraft中连接你的域名:30001或入口服务器的公网ip:30001进行测试，看是否能进入hypixel、延迟表现是否正常。如果正常，你的加速ip已经可以使用了，你可以根据需求和资源来决定是否要部署网页管理功能。删除加速ip时，可使用

python3 proxy.py destroy
#或者 python3 proxyaws.py destroy

这会销毁你创建的所有实例，并在本机和其他入口服务器上终止ZBProxy进程。需要注意Linode的最低计费时长是1小时，如果你的使用时长不足1小时，Linode也会按1小时进行计费，项目中使用的g6-nanode-1已经是Linode的最小规格实例，其价格是0.0075$/hr，请注意你的成本控制。如果脚本由于任何原因销毁失败，请你手动前往Linodes或AWS EC2实例删除实例，防止产生额外费用。

你也可以使用

python3 proxy.py create <num>
python3 proxy.py multicreate port1 port2 ...

来一次创建多个实例，随后你可以通过30001、30002、...、30010端口来连接，每个端口导向的落地ip都是不同的，当有账号被ban时，不会影响到其他端口连接的账号。

最后，由于各家云服务器厂商系统镜像的默认tcp策略不同，在一些服务器上可能需要手动更改一些配置来优化连接策略。

sudo sysctl -w net.core.default_qdisc=fq
sudo sysctl -w net.ipv4.tcp_congestion_control=bbr
sudo sysctl -w net.ipv4.tcp_autocorking=0
sudo sysctl -w net.ipv4.tcp_fastopen=3
sudo sysctl -w net.ipv4.tcp_low_latency=1
CONF_FILE="/etc/sysctl.conf"
sudo sed -i '/net.core.default_qdisc/d' $CONF_FILE
sudo sed -i '/net.ipv4.tcp_congestion_control/d' $CONF_FILE
sudo sed -i '/net.ipv4.tcp_autocorking/d' $CONF_FILE
sudo sed -i '/net.ipv4.tcp_fastopen/d' $CONF_FILE
sudo sed -i '/net.ipv4.tcp_low_latency/d' $CONF_FILE
echo "net.core.default_qdisc=fq" | sudo tee -a $CONF_FILE
echo "net.ipv4.tcp_congestion_control=bbr" | sudo tee -a $CONF_FILE
echo "net.ipv4.tcp_autocorking=0" | sudo tee -a $CONF_FILE
echo "net.ipv4.tcp_fastopen=3" | sudo tee -a $CONF_FILE
echo "net.ipv4.tcp_low_latency=1" | sudo tee -a $CONF_FILE
sudo sysctl -p

2、控制网页的部署

项目中还提供了WebApp。让您可以从网页上轻易创建和销毁实例、复制连接地址，提升易用性。可以根据以下步骤进行搭建:

(1)进入webapp目录并创建一个Python虚拟环境。

cd webapp
python3 -m venv venv
source venv/bin/activate

(2)安装所需的库和nginx反向代理

sudo apt install nginx
pip install boto3 linode_api4 paramiko requests psutil Quart gunicorn uvicorn

(3)在app.py中，找到

ADMIN_PASSWORD = 'ADMIN_PASSWORD'

将其修改为你想要使用的登录密码。

记得把所有的example.com更改为你自己的域名。

(4)使用项目的nginx目录下提供的proxy_manager.conf作为Nginx的配置文件，注意根据你的实际情况修改其中的SSL证书配置和你的文件路径。你可以将它放在nginx的sites-available目录中，也可以创建一个符号链接指向它。然后，

sudo nginx -t
sudo systemctl reload nginx

（5）使用以下命令来启动Web应用:

nohup gunicorn \
    --workers 1 \
    --worker-class uvicorn.workers.UvicornWorker \
    --forwarded-allow-ips='*' \
    --bind 127.0.0.1:5000 \
    --chdir /root/hypixel-proxy/webapp \
    --access-logfile /root/hypixel-proxy/webapp/logs/access.log \
    --error-logfile /root/hypixel-proxy/webapp/logs/error.log \
    app:app &

(6)在浏览器地址栏中输入你的域名/服务器地址，然后输入密码，你应该能看到控制面板界面，可以在输入框中输入要一次性创建的落地实例数量，也可以使用高级模式输入命令来更精细地管理实例。创建的进度和日志都会显示在右边的仿终端区域内。

高级命令使用方法:

create命令:

-o/-override参数: 如果一个端口当前已有正在运行的代理，则先终止该代理，然后再部署代理覆盖。

-l/-lin/-linode参数: 指定Linode。

-a/-aws参数: 指定使用AWS。

端口指定: 用,或:分隔，分别为端口列表和范围。

数量指定: 用~<num>来指定数量。例如: create -o -l 30001:30003 -a ~4在30001-30003端口创建3个Linode代理，然后在空闲端口创建4个AWS代理。

destroy命令:

-p参数: 要销毁的代理端口，端口指定方法同上。不可与-a和-l同时使用。

-a/-aws参数: 销毁所有AWS实例和代理进程。

-l/-lin/-linode参数: 销毁所有Linode实例和代理进程。

-f/-force参数: 即使API销毁失败也清理状态文件。

至此部署流程已经完成。

Lmyzproxy

Install / Use

README