Skip to content
BranchesTags

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

MyWebDisk

无公网 IP 的个人 NAS / 私人网盘服务端 — Personal NAS server over P2P (webrpc)

人在外面也能浏览、上传、下载家里电脑或 NAS 上的文件。不需要公网 IP、不需要路由器端口映射、也不把文件上传到第三方网盘。传输走 webrpc 加密 P2P 通道；电脑端用 File2File Desktop 连接网盘，手机端用 File2File App 连接网盘。

English README

关键词： 个人 NAS、私人网盘、无公网 IP、P2P 网盘、webrpc、File2File、File2File App、macOS / Linux / Windows / Android / iOS、树莓派、ARM NAS

目录

它解决什么问题

把家里的 Mac、Windows 电脑、Linux 小主机或 ARM NAS 变成一台只属于你的网盘：

常见做法 痛点 MyWebDisk
公有云网盘 文件离开自己的硬盘，容量与隐私受限 文件始终在你指定的本地目录
公网 IP + 端口映射 / frp 运营商没公网 IP，穿透配置复杂 不需要公网 IP，webrpc 负责打洞
自建 WebDAV / SMB 暴露公网 暴露端口、证书、防火墙 对端必须同时知道 Token 和口令

适合：出差访问家里照片和文档、跨网络取安装包、给自己搭一台私人云盘。

功能一览

服务端是一条命令即可运行的 Go 程序。绑定一个本地目录后，经 File2File 可完成：

  • 浏览目录：列表 / 图标视图，路径限制在 --path 内，禁止 ../ 越界
  • 磁盘信息：总容量、剩余、已用、文件数量
  • 上传 / 下载：大文件分块传输
  • 新建、重命名、移动、删除 文件和文件夹
  • 搜索 网盘内文件名
  • 打包文件夹 为 zip（带进度）

webrpc 运行库已嵌入各平台可执行文件，发布目录里不需要再附带 .so / .dylib / .dll。

工作原理

  1. 在 NAS / 家里电脑上启动 mywebdisk-server，传入该设备的 webrpc Token、密码、口令 和本地目录。
  2. 服务端登录 webrpc，在本机回调端口上等待会话。
  3. 另一台电脑打开 File2File Desktop，或手机打开 File2File App，用另一枚 Token 登录。
  4. 在「网盘连接」里填写服务端 Token 和同一条口令，建立 P2P 会话。
  5. 之后的列目录、上传下载都走这条加密通道，不经过中心化存储。

两端都要能访问互联网以完成握手；文件内容优先点对点直传。

界面预览

1. 服务端在家里电脑上运行

传入 Token、密码、口令和 NAS 目录后，登录成功即进入待命：

mywebdisk-server 运行日志：webrpc 登录成功并等待客户端会话

2. File2File 连接网盘（连接前）

客户端已登录后，在左侧「网盘连接」选择节点，弹出「请先连接网盘」，填写网盘 Token 和认证口令（与服务端 --permission 一致）：

File2File 连接网盘前：输入网盘 Token 与认证口令

3. 连接成功后的网盘内容

连通后可看磁盘用量、搜索、上传，并以列表或图标浏览家里的文件：

File2File 已连接个人 NAS，浏览家里网盘文件与磁盘用量

你需要准备什么

  1. 两枚 webrpc Token（一枚给服务端，一枚给 File2File）
    在 webrpc 控制台 注册后，到「我的 Token」复制 Token 值 和 密码。
  2. 口令（permission）
    服务端启动时设置，File2File 连接网盘时必须填同一条。不要留空。
  3. 一块本地磁盘目录
    例如 /Users/you/mywebdisk_space、D:\nas、/mnt/data/nas。不存在会自动创建。
  4. 客户端
    电脑端安装 File2File Desktop；手机端安装 File2File App。

各平台部署

仓库 dist/ 目录已提供各平台单文件程序。下载对应文件、赋予执行权限后即可运行。

平台 架构 仓库内路径 适用机器
macOS 11+ Apple Silicon (arm64) dist/darwin-arm64/mywebdisk-server M 系列 Mac
Linux x86_64 (amd64) dist/linux-amd64/mywebdisk-server 普通 x86 NAS / 小主机 / 云主机
Linux ARM64 dist/linux-arm64/mywebdisk-server 树莓派 64 位、ARM NAS、部分软路由
Windows 10/11 x64 dist/windows-amd64/mywebdisk-server.exe 家里的 Windows 电脑

单文件即可，无需再安装 webrpc SDK 或配置动态库路径。

macOS (Apple Silicon)

chmod +x dist/darwin-arm64/mywebdisk-server
./dist/darwin-arm64/mywebdisk-server \
  --token=你的服务端Token \
  --passwd=Token密码 \
  --permission=你设的口令 \
  --path=/Users/你/mywebdisk_space

若系统提示「无法验证开发者」，在「系统设置 → 隐私与安全性」中允许，或执行：

xattr -dr com.apple.quarantine dist/darwin-arm64/mywebdisk-server

Linux x86_64

chmod +x dist/linux-amd64/mywebdisk-server
./dist/linux-amd64/mywebdisk-server \
  --token=你的服务端Token \
  --passwd=Token密码 \
  --permission=你设的口令 \
  --path=/mnt/data/nas

长期挂在 NAS / 小主机上，可用 systemd（把路径和参数改成你的）：

# /etc/systemd/system/mywebdisk.service
[Unit]
Description=MyWebDisk personal NAS (webrpc P2P)
After=network-online.target

[Service]
Type=simple
ExecStart=/opt/mywebdisk/mywebdisk-server --token=TOKEN --passwd=PASSWD --permission=PIN --path=/mnt/data/nas
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now mywebdisk

Linux ARM64（树莓派 / ARM NAS）

chmod +x dist/linux-arm64/mywebdisk-server
./dist/linux-arm64/mywebdisk-server \
  --token=你的服务端Token \
  --passwd=Token密码 \
  --permission=你设的口令 \
  --path=/mnt/usb/nas

请使用 64 位 系统镜像。32 位 ARM 不在当前发布范围内。

Windows x64

在 PowerShell 或「命令提示符」中：

dist\windows-amd64\mywebdisk-server.exe --token=服务端Token --passwd=Token密码 --permission=口令 --path=D:\nas

关机后若要自动起来，可把上述命令做成开机启动脚本，或放到「任务计划程序」。保持窗口不关，或用 nssm 等工具注册为服务。

启动服务端

四个参数都必填：

参数 含义
--token 这台 NAS 设备的 webrpc Token
--passwd 该 Token 在控制台里的密码
--permission 口令。File2File「认证口令」必须与此相同
--path 作为网盘根目录的本地路径；不存在则创建

成功时日志大致如下：

webrpc 客户端已创建，等待登录...
webrpc 登录成功 status=1
NAS 目录: /Users/a1/mywebdisk_space
服务已就绪，等待客户端通过 webrpc 建立会话
已连接 webrpc 回调端口 127.0.0.1:xxxxx

看到「服务已就绪」后再去开 File2File。登录失败会在约 30 秒超时，请核对 Token、密码和网络。Ctrl+C 退出。

用 File2File 连接网盘

  1. 安装并启动客户端（桌面：macOS / Windows / Linux；手机：Android / iOS）。
  2. 用客户端自己的 webrpc Token 和密码登录。认证口令可按 File2File 说明填写；这与网盘口令不是同一件事。
  3. 打开 网盘连接（桌面端在左侧；手机端在「网盘」页），点 新建连接 或选已保存的节点（例如「家里网盘mac」）。
  4. 在连接窗口填写：
    • 网盘 Token：服务端 --token
    • 认证口令：服务端 --permission
  5. 点 连接。成功后即可看磁盘用量、浏览目录、上传、搜索。

服务端必须先在线。只知道 Token 但口令不对，无法建立会话。

从源码编译

环境：Go 1.22+，仓库内 sdk/ 已包含各平台 webrpc 动态库。

git clone https://github.com/xiaoming-software/mywebdisk.git
cd mywebdisk
./build.sh

产物：

dist/darwin-arm64/mywebdisk-server
dist/linux-amd64/mywebdisk-server
dist/linux-arm64/mywebdisk-server
dist/windows-amd64/mywebdisk-server.exe

在 Apple Silicon Mac 上可一次编出上述四个目标（CGO_ENABLED=0 交叉编译，无需 zig）。

安全说明

  • 口令用于限制谁能 OpenSession 连上这台 NAS，请使用足够长的随机口令，不要提交到 Git。
  • 所有文件操作都被限制在 --path 目录内。
  • webrpc 通道默认加密；平台不托管你的文件内容。
  • 仅供合法个人与商业使用。禁止用于法律法规不允许的内容与活动，详见 webrpc 合规说明。
  • Token、密码、口令等同于网盘钥匙，不要发给不信任的人。

常见问题

Q：没有公网 IP 能用吗？
能。这是本项目的主要使用场景。两端能上网即可尝试握手。

Q：File2File 登录用的 Token 和服务端是同一枚吗？
不要共用。一枚给家里的 mywebdisk-server，另一枚给出门用的 File2File。连接网盘时，在客户端里填服务端那枚 Token 和口令。

Q：登录一直超时？
检查 Token / 密码是否从「我的 Token」原样复制、机器能否访问外网、是否用了对应系统的二进制（不要在 Linux 上跑 macOS 文件）。

Q：连接网盘失败？
确认服务端日志已是「服务已就绪」、服务端进程还在跑、口令与 --permission 完全一致、客户端已登录且网络可达。

Q：支持 Intel Mac / Android / iOS 服务端吗？
当前发布的是 darwin-arm64、linux-amd64、linux-arm64、windows-amd64。Android / iOS 不做 NAS 服务端。Intel Mac 不在预编译列表中。

Q：可以当多人共享网盘吗？
协议上多个 File2File 可以连同一台服务端，但本项目按个人 NAS 设计：知道 Token + 口令的人都能操作该目录，请自行控制分享范围。

相关项目

项目 作用
本仓库 MyWebDisk 个人 NAS 服务端
File2File Desktop 电脑端客户端，连接并操作网盘，也支持聊天与直传文件
File2File App 手机端客户端（Android / iOS），连接并操作网盘
webrpc P2P RPC 传输与 Token 服务

问题与建议请在本仓库提 Issue。请自行保管 Token 与口令。

About

基于 webrpc P2P 的个人网盘系统。远程客户端通过点对点加密通道，直接读写服务端指定目录下的文件，在线预览、编辑无需公网 IP 或自建 HTTP 服务。

Topics

cloudfile2filemywebdisknasnasa-datap2pwebdiskwebrpc

Resources

Readme
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Contributors

Languages