准备工作

在开始之前，请确保您的系统中已安装 Git 和 Python 3。

1. 克隆源代码

首先，将项目代码从 GitHub 克隆到您的本地设备，并进入项目目录。

git clone https://github.com/cc004/autopcr.git
cd autopcr

2. 创建并激活 Python 虚拟环境

使用虚拟环境可以隔离项目依赖，避免与系统或其他项目的库产生冲突。

# 如果您的系统中没有 venv 模块，请先安装
# sudo apt update && sudo apt install python3-venv -y

# 在项目根目录创建名为 "venv" 的虚拟环境
python3 -m venv venv

# 激活虚拟环境
source venv/bin/activate

提示：成功激活后，您的终端提示符前会显示 (venv) 字样。后续所有 pip 操作都将在此隔离环境中进行。

3. 安装项目依赖

安装运行 AutoPCR 所需的全部 Python 库。

# 优先升级 pip 工具
pip install --upgrade pip

# 根据 requirements.txt 文件安装所有依赖
pip install -r requirements.txt

注意：如果您不需要 B站自动刷票 功能，可以手动编辑 requirements.txt 文件，删除包含 bili_ticket_gt_python 的那一行。这可以避免因网络问题导致该依赖安装失败或卡住。

4. 下载前端资源

AutoPCR 的用户界面是独立的前端项目，需要单独下载。

方法一：自动下载 (推荐)

执行项目内置的脚本，自动从网络获取最新版前端文件。

python3 _download_web.py

说明：执行成功后，项目根目录下会生成一个 web/ 文件夹，其中包含 index.html 等前端页面文件。

方法二：手动下载 (备用方案)

如果自动下载失败，可以手动下载后进行安装。

1. 访问 AutoPCR\_Web 最新发布页面，下载 web.zip 压缩包。
2. 将下载的 web.zip 文件放置在 autopcr 项目的根目录。
3. 执行以下命令进行安装：

python3 _download_web.py web.zip

5. 启动与访问服务

方式一：前台测试运行

此模式会将日志直接输出到当前终端，方便调试。关闭终端后服务会中断。

python3 _httpserver_test.py

方式二：后台部署运行

使用 nohup 命令让服务在后台持续运行，并将日志记录到文件中。

nohup python3 _httpserver_test.py > httpserver.log 2>&1 &

常用管理命令

• 实时查看日志：

  tail -f httpserver.log

• 停止服务：

  pkill -f _httpserver_test.py

访问应用

服务启动后，在浏览器中打开 http://<你的服务器IP>:8000 即可访问 AutoPCR 界面。如果是在本机运行，则访问 http://127.0.0.1:8000。

6. 日常更新

1. 进入项目目录 (请根据您的实际路径修改)：

   cd /opt/autopcr

2. 停止当前运行的服务 (重要！)：

   pkill -f _httpserver_test.py

3. 激活虚拟环境：

   source venv/bin/activate

4. 拉取最新代码：

   git pull origin main

5. 更新依赖库：

   pip install -r requirements.txt

6. 更新前端资源 (确保前后端版本匹配)：

   python3 _download_web.py

7. 重新启动服务：

   nohup python3 _httpserver_test.py > httpserver.log 2>&1 &