Immich 手机端首次登录：服务器地址怎么填才连得上

打开 Immich App 的第一个界面就是服务器登录。这个页面的体验和云相册完全不同：没有预置服务器，你必须告诉 App 你的服务在哪里。填对了往下一切顺畅，填错了就是新手的第一个坎。

地址格式

登录页要填的是一个 URL，格式就是你平时在电脑浏览器里访问 Immich 的那个地址：

http://192.168.1.10:2283

把 IP 换成你服务器的实际地址即可。几个细节：

• 端口 2283 是默认端口，部署时 没改过就是它；
• 协议前缀别省，局域网直连就是 http://；
• 老教程里常见的 http://IP:2283/api 写法是旧版 App 的要求，新版直接填根地址就行。

填完点连接，App 会握手验证，通过后输入你 注册管理员时（或家人账号）的邮箱密码，进入时间线。

场景一：家里局域网（绝大多数人的起点）

手机和服务器连同一个 Wi-Fi，地址就是服务器的内网 IP。怎么查：装 Docker 那台机器上敲 ip addr（Linux）或看路由器后台的设备列表。这是最简单、最快、也最安全的形态。

场景二：在外面也想连（外网访问）

出门在外内网 IP 就够不着了，常见解法按复杂度排：

• VPN 回家：在路由器或服务器上搭 WireGuard 等 VPN，手机连上 VPN 后用内网地址访问——安全且不暴露服务，是有一定动手能力用户的推荐解；
• 反向代理 + 域名：给服务套一层 Nginx/Caddy 反代并配 HTTPS，官方文档有 reverse-proxy 专页讲转发规则；
• 自签名证书的坑：App 对自签名证书、Basic Auth 等实验性网络特性的支持不完善，视频播放和上传经常出问题——官方明确建议用受信任的证书（比如 Let's Encrypt）替代。

无论哪种方案，改完网络配置后回到 备份设置 检查「仅 Wi-Fi 上传」的条件是否还成立。

连不上时的排查顺序

1. 电脑浏览器能不能打开同一个地址？打不开是服务器或网络问题，不是 App 问题；
2. App 和服务器版本是否同线？官方 FAQ 把「大版本不一致」列为登录失败首因，商店审核延迟常造成几天的错位；
3. 密码对不对？去网页端登录一次验证凭据；
4. 还不行，看 App 内的日志页找报错关键词，对照 常见问题排查。

登录成功后，时间线还是空的——下一站就是让照片进来：开启自动备份。