PhotoPrism是一款开源的AI照片管理利器。它基于深度学习，可自动识别人脸、场景与物体，帮你把零散的照片整理成可搜索、可分享的视觉档案。本文用「Docker 容器 + 贝锐花生壳内网穿透」打造外发访问地址，教你10分钟在本地或云端搭好PhotoPrism，并通过公网地址随时随地访问。
一、准备工作：安装Docker
首先一键脚本安装
启动Docker
脚本会自动把Docker服务设为开机自启。
2. 给Docker加速
如果镜像拉取缓慢，可在 /etc/docker/daemon.json 中加入常用国内镜像源，例如：
保存后执行 sudo systemctl restart docker 即刻生效。
二、 拉取官方镜像
使用docker拉取Photoprism的最新镜像。镜像约2 GB，耐心等待即可。
三、运行容器
一条命令即可启动，关键目录都做了持久化映射：
参数说明：
- `-p 2342:2342` 把容器内部 2342 端口映射到宿主机同端口；
- `PHOTOPRISM_ADMIN_PASSWORD` 设置Web管理员初始密码，首次登录后可在后台修改；
- `-v ~/Pictures:/photoprism/originals` 把主目录下的 Pictures 文件夹挂载为PhotoPrism的图库根目录，后续直接往该目录丢照片即可自动索引。
容器启动后，浏览器访问http://<本机IP>:2342（示例：http://10.168.123.227:2342），输入用户名admin与刚才设置的密码即可进入后台。上传照片后，系统会自动进行人脸识别、场景分类与地图定位，几分钟内就能通过关键词搜索到目标相片。
四、外网访问：贝锐花生壳内网穿透
若想把云相册开放给家人或在外网随时查看，可用贝锐花生壳做内网穿透，无需公网IP。
1. 下载安装客户端
在贝锐花生壳官网，安装docker-Android模拟器或可访问docker-Android模拟器的内网终端设备上。
接着，在运行PhotoPrism的同一台机器上执行，安装完成会自动生成SN码，默认密码为admin：
2. 激活设备
打开浏览器访问http://b.oray.com/，输入SN与默认密码登录。首次登录需扫码或绑定贝锐账号完成激活。
3. 添加映射
在控制台选择【内网穿透】→【添加映射】，填写：
- 应用名称：PhotoPrism
- 内网主机：Docker宿主机局域网IP（如 192.168.1.100）
- 内网端口：2342
- 外网域名：系统会自动分配，也可自定义二级域名
保存后，贝锐花生壳会自动生成一个外网地址。
4. 随时随地访问photoprism
手机、平板或电脑浏览器输入该外网地址，即可安全访问你部署在家里的PhotoPrism，上传、浏览、搜索照片全部在线完成。
到此，你的个人AI云相册已上线。把旅途、生活与工作的所有影像交给 PhotoPrism，它会用算法帮你留住每一份记忆。
