前言

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 技术，既保障了本地数据的隐私与控制权，又突破了局域网限制，让文件传输更加灵活便捷，非常适合有日常共享需求的用户部署尝试。