发帖
雷达卡
前言
PicoShare 是一款轻量级的本地文件共享工具，能够帮助用户在不同设备之间快速传输照片、视频、文档等各类文件。相比传统的 FTP 方式，其操作更为简便，特别适合摄影爱好者、自由职业者以及家庭用户使用。无需复杂的配置即可快速搭建个人专属的文件共享环境。
在实际使用中，PicoShare 的界面设计简洁直观，上传文件后可自定义分享链接的有效时间，提升了使用的灵活性与安全性。但需要注意的是，首次设置的登录密码务必牢记，否则将影响后续的访问体验。
然而，PicoShare 默认仅支持局域网内访问。这意味着如果想从外部网络获取家中电脑上的文件，或向异地亲友发送手机中的大视频，便无法直接实现，必须依赖云盘进行中转，不仅速度慢还消耗大量流量。
通过结合 cpolar 内网穿透技术，可以轻松解决这一限制。无需更改路由器设置或申请公网 IP，即可为本地运行的 PicoShare 服务生成一个可被公网访问的地址。无论是在外使用手机流量，还是通过异地电脑连接，都能稳定高效地进行文件传输。
接下来，我们将详细介绍如何在本地部署 PicoShare，并借助 cpolar 实现跨网络远程访问。
1. Docker 的本地安装
本次演示基于 Ubuntu 22.04 系统环境，首先需要完成 Docker 的安装。
在终端中执行以下命令，使用一键脚本安装 Docker：
sudo curl -fsSL https://gitee.com/tech-shrimp/docker_installer/releases/download/latest/linux.sh | bash -s docker --mirror Aliyun
1.1 配置 Docker 镜像加速源
为了提升镜像拉取速度，建议配置国内镜像源。在终端执行以下命令以编辑配置文件：
sudo nano /etc/docker/daemon.json
将以下内容复制并粘贴至文件中，保存后退出：
{
"registry-mirrors": [
"https://hub.geekery.cn/",
"https://ghcr.geekery.cn"
]
}
随后重启 Docker 服务以应用更改：
sudo systemctl restart docker
2. 在本地部署 PicoShare 服务
通过 Docker 容器化方式运行 PicoShare，推荐挂载本地目录用于持久化存储数据库信息。
执行如下命令启动容器：
sudo docker run \
--env "PORT=4001" \
--env "PS_SHARED_SECRET=somesecretpass" \
--publish 4001:4001/tcp \
--volume "${PWD}/data:/data" \
--name picoshare \
mtlynch/picoshare
3. PicoShare 使用方法
部署完成后，打开浏览器访问 localhost:4001 或本机局域网 IP 地址加端口（如：192.168.x.x:4001）即可进入登录页面。
点击“Log in”，输入部署时设定的密码（示例中为 somesecretpass）完成登录。
进入主界面后，点击“Choose a file…”按钮选择要上传的文件。
文件上传成功后，系统会自动生成一个下载链接，点击该链接可立即下载文件，也可将其分享给他人使用。
在“Files”模块中，用户还可以调整已上传文件的保存期限，灵活控制分享时效。
目前 PicoShare 已在本地成功运行，但仅限于局域网内部访问。若希望将文件分享链接对外发布，供公网用户访问，则需进一步配置公网可达地址。
此时，可通过 cpolar 内网穿透工具实现外网访问功能，真正做到随时随地跨设备传输文件，并支持将生成的公网链接广泛分享。
4. 实现公网远程访问本地 PicoShare
4.1 安装内网穿透工具 cpolar
以下是 cpolar 的安装步骤：
访问官方站点获取更多信息：
https://www.cpolar.com
使用一键安装脚本执行安装：
sudo curl https://get.cpolar.sh | sh
安装完成后，可通过以下命令检查 cpolar 服务状态，确认是否正常运行：
sudo systemctl status cpolar
当 cpolar 成功安装并启动后，在浏览器中输入 Ubuntu 主机的 IP 地址并加上 9200 端口（例如：http://localhost:9200），即可进入管理界面进行隧道配置。
5. 固定 PicoShare 的公网访问地址
通过 cpolar 创建临时或固定的公网隧道，将本地 4001 端口映射至公网 URL。配置完成后，即使设备位于 NAT 或防火墙之后，也能实现稳定的远程访问。
结合 PicoShare 与 cpolar 的方案，既保留了本地文件共享的安全性和便捷性，又突破了局域网的地理限制，实现了真正的跨地域、跨设备文件共享体验。对于有日常文件交换需求的用户而言，是一种简单高效的解决方案。
登录Cpolar官网注册的账号后，进入cpolar管理界面，即可访问其Web配置页面。在该界面中，可以进行后续的各项远程连接设置操作。
5. 配置固定公网地址
由于此前创建的隧道使用的是随机生成的HTTP公网地址，该地址会在24小时内发生变动，不适合长期稳定访问。若希望将PicoShare平台持续对外提供服务，并便于他人访问和分享，则建议配置一个固定的二级子域名作为公网地址。
需要注意的是，使用固定二级子域名功能需将cpolar账户套餐升级至基础版或更高版本，不同套餐对应不同的带宽性能。【cpolar.cn已备案】
首先，登录cpolar官网，在左侧菜单中点击“预留”，选择“保留二级子域名”。地区建议选择China VIP Top，填写所需的二级子域名名称并添加备注信息，确认后点击保留。
保留成功后，复制所生成的二级子域名地址以备后续使用。
4.2 建立远程公网访问隧道
进入cpolar web UI管理界面后，点击左侧仪表盘中的“隧道管理”选项，然后选择“创建隧道”：
- 隧道名称：可自行定义，本示例中命名为 PicoShare，请确保不与已有隧道重名
- 协议类型：选择 http
- 本地地址：填写 4001
- 域名类型：初始阶段可选“随机域名”
- 地区设置：推荐选择 China Top
隧道创建完成后，返回左侧的“在线隧道列表”，此时会显示系统自动生成的两个公网地址。通过任意一台异地设备，在浏览器中输入其中一个地址即可实现对本地部署的PicoShare服务的远程访问。
如下图所示，已成功通过公网地址从外部网络访问到本地运行的PicoShare实例。
同时，文件分享所使用的链接也已变更为当前可用的公网地址。
更新隧道以启用固定地址
为了实现永久稳定的远程访问，接下来需要将之前创建的隧道修改为使用已保留的二级子域名。
在cpolar web UI中，进入“隧道管理”下的“隧道列表”，找到目标隧道，点击右侧的编辑按钮（即修改入口）。
编辑
在编辑界面中进行如下调整：
- 域名类型：更改为“二级子域名”
- Sub Domain：填入先前保留成功的二级子域名
- 地区：设置为 China VIP
完成配置后，点击“更新”按钮提交更改。
更新
更新完毕后，再次查看在线隧道列表，原随机公网地址已被替换为固定不变的二级子域名地址。
使用该固定公网地址访问PicoShare界面，确认访问正常，表明永久远程访问通道已成功建立。
此时，分享出的链接也将同步更新为设定好的固定公网地址。
总结
本文演示了如何利用cpolar实现本地PicoShare文件共享系统的远程访问。初期可通过随机公网地址快速搭建临时通道，适用于短期测试；而通过保留二级子域名的方式配置固定地址，则更适合长期使用场景。
借助这一组合方案，用户无需购置云服务器，也能实现跨地域、跨设备的高效文件共享。无论个人使用还是团队协作，均可轻松完成异地访问与资源分发。
PicoShare 结合 cpolar 技术，既保障了本地数据的隐私与控制权，又突破了局域网限制，让文件传输更加灵活便捷，非常适合有日常共享需求的用户部署尝试。
京公网安备 11010802022788号
