软件测试 发表于 2026-8-1 15:10:00

Copyparty 1.20.19

一、介绍

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

速度

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

仓库:copyparty

二、使用

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

conf示例:

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

# ====================== 【全局区块 global】服务整体基础配置 ======================
# 等价于命令行参数,参数前后横杠可省略;行内注释需要在 # 前面加两个空格

p: 8086, 3939      # 同时监听两个Web端口:8086、3939
e2dsa                # 开启全盘文件索引 + 启动自动扫描所有目录文件
e2ts               # 开启音视频、图片等媒体文件元数据索引,方便检索影音
qr                   # 页面展示局域网访问二维码,搭配zeroconf局域网设备自动发现
usernames            # 登录页面显示已存在的用户名列表
no-ftp # 关闭 FTP 服务
no-tftp # 关闭 TFTP 协议

# ====================== 【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
#   accs:
#   r: k      # 用户k:仅能浏览、下载(只读)
#   rw: ed    # 用户ed:可读可写,可上传修改文件

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

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

# ====================== 示例4: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

林间 发表于 2026-8-4 00:34:12

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

打盹的猫杂谈 发表于 2026-8-5 07:41:23

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

清和记事 发表于 2026-8-6 13:25:56

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

流浪随笔 发表于 2026-8-7 09:32:10

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

关山闲话 发表于 2026-8-8 10:52:21

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

竹里51 发表于 2026-8-9 05:02:55

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

北岛 发表于 2026-8-10 14:05:46

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

陆离 发表于 2026-8-11 14:03:20

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

山有木75 发表于 2026-8-13 02:40:59

这篇值得慢慢看,我准备再读第二遍。有没有后续?想蹲一个更新。
页: [1] 2 3 4 5
查看完整版本: Copyparty 1.20.19