Linux 环境下的 Nonebot2 QQ机器人搭建指南#

1. 安装 NapCat#

推荐使用 Docker 方式安装 NapCat，具体步骤请参考官方文档。安装完成后，按照框架接入指南完成配置。

2. 环境迁移准备#

如果你已在本地环境调试好机器人，可以通过复制以下文件到服务器来快速部署：

• src 文件夹
• pyproject.toml
• poetry.lock

1. 系统更新#

先更新一下包管理器的包列表，确保系统是最新的：

sudo apt update

2. 安装必要依赖#

安装编译 Python 需要的一些工具和库：

sudo apt install -y software-properties-common
sudo apt install -y build-essential libssl-dev zlib1g-dev libbz2-dev \
libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev \
libffi-dev liblzma-dev python3-openssl git

3. 添加 Python PPA#

使用 Python 官方的 PPA 仓库来安装特定版本的 Python：

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update

4. 安装 Python 3.10#

安装 Python 3.10.12：

sudo apt install python3.10

5. 配置 pip#

安装 Python 包管理工具 pip：

sudo apt install python3.10-distutils
wget https://bootstrap.pypa.io/get-pip.py
sudo python3.10 get-pip.py

6. 验证安装#

最后，检查 Python 版本，确保安装成功：

python3.10 --version

💡 如果显示 Python 3.10.11，则表示安装成功。

1. 安装和配置 Clash#

推荐参考详细教程配置 Clash 代理。配置完成后，可以使用以下命令控制 Clash：

systemctl start clash # 启动代理
systemctl stop clash # 停止代理

2. 代理相关命令#

查看当前代理设置
echo $http_proxy
echo $https_proxy

临时关闭代理
unset http_proxy https_proxy all_proxy

3. SSL 错误解决#

如果遇到 SSL 错误：error:0a000126:ssl routines::unexpected eof while reading，可以参考这篇文章解决。