从 零 到 一 五 分 钟 快 速 部 署 小 团 队 适 用 的 免 费 开 源 档 案 门 户

前期准备

本次使用 ArchiveBox 0.7.2 作为底层档案系统，轻量免配置复杂数据库，可直接部署在本地或云服务器（以 Ubuntu 22.04 LTS 本地虚拟机为例，Windows/Mac 用户可直接跳过「前置依赖安装」用 Docker Desktop）。

前置依赖（Ubuntu 22.04 LTS）

• 操作系统：Ubuntu 22.04 LTS（官方推荐，兼容性最高）
• 硬件：至少 2核CPU、4GB内存、100GB可用磁盘（取决于档案存储量）

依次执行以下命令安装依赖：

```bash 更新系统软件源 sudo apt update && sudo apt upgrade -y 安装基础工具 sudo apt install curl wget git python3 python3-pip python3-venv -y 安装可选但必需的多格式归档依赖（PDF、截图、音频、视频等） sudo apt install chromium-browser chromium-chromedriver ffmpeg youtube-dl -y ```

Windows/Mac 前置准备

直接下载安装 Docker Desktop 即可，官方地址：https://www.docker.com/products/docker-desktop/，安装完成后启动并确保右下角状态栏显示「Docker Desktop is running」。

正式部署

Ubuntu 本地部署方式

1. 创建并激活虚拟环境（避免系统Python依赖冲突）：

```bash 创建目录并进入 mkdir -p ~/archivebox && cd ~/archivebox 创建Python虚拟环境 python3 -m venv venv 激活虚拟环境 source venv/bin/activate ```

2. 安装 ArchiveBox：

```bash 使用国内清华镜像源加速安装（可选但必需，避免网络超时） pip3 install archivebox -i https://pypi.tuna.tsinghua.edu.cn/simple ```

3. 初始化档案库：

```bash 创建档案数据目录并初始化（按提示创建管理员账户，注意密码至少8位） archivebox init ```

4. 启动本地服务：

```bash 启动服务（默认监听0.0.0.0:8000，允许局域网访问） archivebox server 0.0.0.0:8000 ```

5. 验证部署：打开浏览器访问 http://你的Ubuntu本地IP:8000 或 http://localhost:8000，输入初始化时的管理员账户密码即可登录。

Docker 跨平台部署方式（推荐）

1. 创建档案存储目录（Windows用户建议创建在D盘或E盘根目录，路径不含中文，如D:\archivebox；Mac用户建议创建在~/Documents/archivebox）：

• Windows PowerShell命令：

```powershell mkdir D:\archivebox ```

• Mac/Linux终端命令：

```bash mkdir -p ~/Documents/archivebox && cd ~/Documents/archivebox ```

2. 下载并启动ArchiveBox容器：

• Windows PowerShell/Mac/Linux终端通用命令：

```bash 拉取官方最新镜像并启动，自动设置端口映射、目录挂载、时区为上海 docker run -d \ --name archivebox \ -p 8000:8000 \ -v $(pwd):/data \ -e PUID=$(id -u) \ -e PGID=$(id -g) \ -e TZ=Asia/Shanghai \ archivebox/archivebox:latest \ server 0.0.0.0:8000 ```

• Windows PowerShell特殊替换（注意替换路径和id命令）：

```powershell 先获取当前用户ID（替换命令中的1000和1000为你的实际ID，通常都是1000） 再执行 docker run -d ` --name archivebox ` -p 8000:8000 ` -v D:\archivebox:/data ` -e PUID=1000 ` -e PGID=1000 ` -e TZ=Asia/Shanghai ` archivebox/archivebox:latest ` server 0.0.0.0:8000 ```

3. 初始化容器内的管理员账户：

```bash 进入容器执行初始化（按提示创建管理员账户） docker exec -it archivebox archivebox init ```

4. 验证部署：打开浏览器访问 http://localhost:8000 或 http://你的设备局域网IP:8000 即可登录。

核心功能实操

单条/批量添加档案

1. 单条网页添加：登录后点击右上角「Add URLs」，输入单条网页链接，点击「Add & Archive Now」即可。

2. 批量添加：点击「Add URLs」，选择「From File」上传.txt格式的链接列表（每行一条链接），或直接粘贴多行链接，选择「Add & Archive Now」。

3. 自定义归档格式：添加前勾选「Advanced options」，可选PDF、截图、原始HTML、音视频提取、Wayback Machine同步等格式，默认全选。

分类管理档案

1. 创建标签：登录后点击左侧「Tags」，点击「Add Tag」输入标签名称（如「技术文档」「团队会议」），点击「Save」。

2. 为档案打标签：点击档案列表中的任意档案，进入详情页，点击右侧「Tags」栏的「+ Add Tags」，选择或输入标签，点击「Save」。

3. 按标签筛选：点击左侧对应标签名称，即可查看该标签下的所有档案。

分享档案

1. 公开分享单条档案：进入档案详情页，点击右上角「Share」，复制「Public Link」即可分享给他人（需在管理后台开启公开访问权限）。

2. 开启公开访问权限：点击右上角「Admin」→ 左侧「Settings」→ 滚动到「Public Access」，勾选「Allow unauthenticated users to view archives」，点击「Save」。

常见卡壳问题解决

1. 归档速度慢/失败：

• 检查chromium是否启动失败：Ubuntu用户执行chromium-browser --no-sandbox测试，若报错需加启动参数；
• 关闭不必要的归档格式：添加链接前在「Advanced options」中取消勾选不需要的格式；
• Windows/Mac Docker用户增加容器内存：打开Docker Desktop → 「Settings」→ 「Resources」→ 「Memory」调整到至少4GB，点击「Apply & Restart」。

2. 局域网无法访问：

• 检查防火墙：Ubuntu用户执行sudo ufw allow 8000/tcp开放端口；
• 检查容器/服务是否绑定0.0.0.0：确认部署命令或启动参数包含0.0.0.0:8000。

3. 数据备份：

• 直接备份整个档案数据目录（Ubuntu的~/archivebox、Windows的D:\archivebox、Mac的~/Documents/archivebox）即可；
• Docker容器内数据也已同步到挂载目录，无需额外备份容器。