使用chfs创建webDAV挂载节点实现局域网内文件访问

处理使用chfs创建webDAV挂载节点实现局域网内文件访问这类问题时，先确认目标场景，再按步骤核对配置或玩法细节。

macOS 安装、配置、运行 chfs 完整整理

一、软件说明

chfs（Cute HTTP File Server）：轻量 HTTP/WebDAV 文件共享服务，替代 SMB/NFS，局域网播放视频流畅，支持多文件夹共享、只读权限，适配 iPhone 浏览器、播放器（nPlayer/Infuse/VLC）。

二、安装 chfs（二选一）

方式1：Homebrew 安装（推荐）

终端执行：

brew install chfs

方式2：手动安装（无 Homebrew 时使用）

0. 官网下载对应 macOS 版本：github.com/chenxiaolon…或者iscute.cn/chfs
1. 解压后将 chfs 二进制文件放入 /usr/local/bin
2. 赋予执行权限：

chmod +x /usr/local/bin/chfs

三、创建配置文件（核心，旧版 chfs 仅支持配置文件写规则/多目录）

1. 新建存放目录 & 配置文件

mkdir -p /Users/xxx/chfsnano /Users/xxx/chfs/chfs.ini

2. 写入配置内容

port=8080# 共享多个文件夹，一行一个 pathpath=/Users/xxx/Downloads/Vpath=/Volumes/HIKSEMI# 匿名用户只读，禁止上传/删除rule=::R

1. 新增共享目录：继续追加 path=目标文件夹绝对路径
2. rule=::R：全局匿名只读，保障文件安全

3. 保存退出编辑器

Ctrl+O → 回车确认 → Ctrl+X

四、前台启动（测试用，关闭终端服务停止）

适合临时使用、排查问题：

chfs --file=/Users/xxx/chfs/chfs.ini

启动成功会输出：共享目录、监听端口、网页地址、WebDAV 地址。

五、后台常驻启动（推荐，关闭终端仍运行）

1. 先终止已运行的 chfs（避免端口冲突）

pkill chfs

2. 后台启动（日志输出到本地）

nohup chfs --file=/Users/xxx/chfs/chfs.ini >/Users/xxx/chfs/chfs.log2>&1 &

3. 查看运行日志（排查异常）

cat /Users/xxx/chfs/chfs.log

六、停止服务

pkill chfs

七、iPhone 访问方式（同一局域网 WiFi）

1. 网页直接播放（无需额外 APP）

浏览器访问：

http://192.168.31.131:8080

2. WebDAV 挂载（播放器专用，体验更佳）

nPlayer/Infuse/VLC 等软件新建 WebDAV 连接：

1. 地址：http://192.168.31.131:8080/webdav
2. 用户名、密码：留空 保存后即可流式播放视频。

八、常用维护操作

0. 新增共享文件夹 编辑配置文件，追加 path 配置：

nano /Users/xxx/chfs/chfs.ini

示例追加：path=/Users/xxx/Movies，保存后重启服务生效。

2. 修改端口 修改 chfs.ini 内 port=xxx，例如 port=8081，重启服务即可。

九、补充注意事项

0. 路径必须使用绝对路径，命令行/配置文件不识别 ~ 波浪号；
1. 手机优先连接 5G WiFi，Mac 建议网线接路由器，视频播放更流畅；
2. 当前配置为只读模式，无法上传、修改、删除电脑文件，内网使用安全；
3. macOS 防火墙默认放行 8080 端口，无需额外配置。