Copyparty 1.20.19

软件测试

一、介绍

Copyparty 是开源的，由 Python 编写的单文件轻量化跨平台文件服务器。整个程序打包为单个 py, sfx 脚本或 exe 程序，不用繁琐的环境配置安装Windows、Linux、macOS、安卓 Termux、路由器、NAS、老旧主机全都可以运行，内存占用极低，既能做局域网临时传文件工具，也能长期部署为私人自建网盘，是局域网传文件的升档选择（速度挺快的，自测有80MB/S）。

速度

功能层面集合了多协议传输、稳定文件收发、精细化权限与网页管理功能。支持文件断点续传、文件边上传边下载，还会自动对重复文件做硬链接去重，节省硬盘空间。网页端可直接在线预览图片、播放音视频；管理员可划分不同共享目录，设置账号密码，区分管理员读写、普通用户、匿名只读多层权限。

仓库：copyparty

二、使用

建议编写conf然后通过 [Plain Text] 纯文本查看 复制代码py copyparty-sfx.py -c 设置.conf 启动

conf示例：

[Bash shell] 纯文本查看 复制代码# 配置文件标识，编辑器识别配置格式用，不用改动
# -*- mode: yaml -*-
# vim: ft=yaml:

# ====================== 【全局区块 global】服务整体基础配置 ======================
# 等价于命令行参数，参数前后横杠可省略；行内注释需要在 # 前面加两个空格
[global]
  p: 8086, 3939        # 同时监听两个Web端口：8086、3939
  e2dsa                # 开启全盘文件索引 + 启动自动扫描所有目录文件
  e2ts                 # 开启音视频、图片等媒体文件元数据索引，方便检索影音
  qr                   # 页面展示局域网访问二维码，搭配zeroconf局域网设备自动发现
  usernames            # 登录页面显示已存在的用户名列表
no-ftp # 关闭 FTP 服务
no-tftp # 关闭 TFTP 协议

# ====================== 【accounts 账号管理区块】定义所有登录账号 ======================
# 格式：用户名: 密码，都可自行修改
[accounts]
  admin: admin123      # 管理员账号：用户名admin，密码admin123

# ====================== 【挂载目录 根目录 /】网页访问根路径配置 ======================
# [/]: 浏览器访问根地址 http://IP:端口/ 对应的页面
# 下一行填写：本机实际文件夹路径
[/]
  ./file               # 把程序同级目录下的 file 文件夹，映射为网页根目录
  accs:                # accs = access 权限分配
    g: *               # g=guest 所有匿名访客、访客默认只读权限
    rw: upload         # upload 这个账号拥有读写权限（上传、修改文件）
    A: admin           # admin 账号拥有最高管理员全权限（删除、修改配置、全部操作）

# ====================== 示例1：私密目录 /priv （被注释，按需取消#使用） ======================
# 网页访问地址：http://IP:端口/priv
# 本机路径：程序目录下的 priv 文件夹
# [/priv]
#   ./priv
#   accs:
#     r: k      # 用户k：仅能浏览、下载（只读）
#     rw: ed    # 用户ed：可读可写，可上传修改文件

# ====================== 示例2：音乐库公开只读分享 ======================
# 网页路径 /music 映射本机 /home/ed/Music 音乐文件夹，所有人只能查看下载
# [/music]
#   /home/ed/Music
#   accs:
#     r: *      # 星号*代表所有用户、匿名访客全部只读访问

# ====================== 示例3：公共上传垃圾箱，所有人可上传，但看不到文件列表 ======================
# 访问 /dump 任何人都能上传文件，但无法浏览、下载里面的内容
# [/dump]
#   /home/ed/inc
#   accs:
#     w: *               # 全员只开放写入（上传）权限，无读取权限
#   flags:               # flags：该目录专属附加功能标记
#     e2d                # 开启此目录上传记录数据库
#     nodupe             # 开启去重，重复文件拒绝二次上传，节省磁盘空间
#     # 所有目录标记可执行：python copyparty-sfx.py --help-flags 查看全部说明

# ====================== 示例4：ShareX截图上传目录（仅本人可见自己上传的文件） ======================
# 通用截图工具ShareX对接上传，用户只能查看、管理自己上传的文件，看不到别人文件
# [/sharex]
#   /home/ed/inc/sharex
#   accs:
#     wG: *              # wG：写入+仅查看本人上传文件，全员开放上传
#     rwmd: ed, k        # ed、k两位用户拥有完整读写、修改、删除权限
#   flags:
#     e2d, d2t, fk: 4
#     # e2d：上传数据库记录
#     # d2t：关闭媒体解析，防止恶意上传文件造成安全风险
#     # fk:4 开启文件密钥功能，密钥长度4位，配合wG权限实现隔离文件

# ====================== 补充说明 ======================
# 这份格式配置，等价于一长串原始命令行参数写法，配置文件优先级高于命令行
# 加载此配置启动命令：
# python copyparty-sfx.py -c 你的配置文件名.conf
# 配置校验（只解析不启动服务，排错专用）
# python copyparty-sfx.py -c 你的配置文件名.conf --dry-run

py copyparty-sfx.py -c .conf运行后查看终端会发现它输出了一长串地址，找到有external标签的就是可以局域网直接访问的

然后根据你设置的用户名和密码就可以访问啦！

详情可见官方仓库

仓库：copyparty

林间

写得挺细致的，能看出是实操过的。有遇到类似情况的吗？想听听别人的做法。

打盹的猫杂谈

楼主说得挺实在，比那些空谈概念的强。

清和记事

信息量挺足的，看了一遍还想再看一遍。期待后续的补充。

流浪随笔

观点有依据，不是拍脑袋得出来的。

关山闲话

同意大部分观点，不过有一点想补充。有遇到类似情况的吗？想听听别人的做法。

竹里51

看完之后对这块的认识清晰了不少。

北岛

内容挺扎实的，不是那种拼凑出来的。

陆离

这个案例很有代表性，能说明不少问题。有没有后续？想蹲一个更新。

山有木75

这篇值得慢慢看，我准备再读第二遍。有没有后续？想蹲一个更新。