1. 为什么选择copyparty作为本地文件服务器
在众多轻量级文件服务器方案中，copyparty以其极简设计和零配置特性脱颖而出。这个基于Python的单文件应用，大小不足1MB，却完整实现了HTTP文件共享服务。我最初选择它是因为需要在不同设备间快速共享开发文档，而传统方案如Nextcloud或Seafile都显得过于笨重。
copyparty的核心优势在于：
- 真正的开箱即用：只需一个Python解释器，无需数据库或复杂依赖
- 跨平台支持：Windows/macOS/Linux均可运行，ARM设备兼容性良好
- 资源占用极低：在我的树莓派4B上内存占用长期保持在30MB以下
- 功能完备：支持上传下载、目录浏览、搜索、缩略图等基础功能
提示：虽然copyparty支持密码保护，但不建议直接将其暴露在公网。正确的做法是配合内网穿透工具使用，我们会在第4章详细说明。
2. 本地部署copyparty的完整流程
2.1 基础环境准备
首先确保系统已安装Python 3.6+。推荐使用虚拟环境隔离依赖：
bash复制python -m venv copyparty_venv
source copyparty_venv/bin/activate # Linux/macOS
# 或 copyparty_venv\Scripts\activate.bat (Windows)
通过pip安装最新版copyparty：
bash复制pip install copyparty
2.2 启动基础服务
最简单的启动方式是指定共享目录：
bash复制copyparty /path/to/shared_folder
服务默认监听127.0.0.1:3923，可通过浏览器访问http://localhost:3923查看。如果需要允许局域网访问：
bash复制copyparty -i 0.0.0.0 /path/to/shared_folder
2.3 常用配置参数
实际部署时建议使用配置文件（如cfg.yml）：
yaml复制# 监听设置
port: 8080
host: 0.0.0.0
# 共享目录配置
volumes:
/data/docs: