企业官网建设流程全解析

Ente Photos 全平台安装指南：iOS、Android、桌面端、Web 与 CLI 完整攻略

【免费下载链接】ente💚 End-to-end encrypted cloud for everything.项目地址: https://gitcode.com/GitHub_Trending/en/ente

Ente Photos 是一款端到端加密的云相册应用，支持在 iOS/iPadOS、Android、macOS、Windows、Linux、Web 浏览器以及无图形界面的服务器环境（CLI）中运行。本文以官方安装文档为骨架，结合仓库源码，为你完整梳理每个平台的下载渠道、安装要点、APK 签名校验、桌面端系统要求与 CLI 命令行工具的安装使用，帮助你在一台或多台设备上快速部署 Ente Photos 并开始备份照片。

iOS 和 iPadOS：App Store 一键安装

在 Apple 设备上安装 Ente Photos 最简单的方式是直接从 iOS App Store 下载。App Store 安装会自动处理签名、更新与 iCloud 相关权限，无需额外配置。

安装完成后打开应用，即可进入注册或登录流程。需要注意，如果你已有 Ente Auth 账户，并且计划在 Ente Auth 中存储 Ente Photos 的 2FA 验证码，官方建议为 Photos 和 Auth 分别使用独立账户，避免出现「自我验证」的循环问题。

Android：按偏好选择多个分发渠道

Ente Photos 的 Android 版本（包名io.ente.photos）通过多个渠道分发，你可以根据自己的偏好（是否使用 Google 服务、是否追求最新版本、是否需要自动跟随 GitHub 发布）选择其一：

• Play Store：io.ente.photos，适合多数用户，自动更新。
• F-Droid：io.ente.photos.fdroid，适合无 Google 服务的设备。注意 F-Droid 使用自己的构建服务器，新版本通常比官方发布延迟约 2 周。
• GitHub Releases：直接下载 APK（匹配photos-v1系列标签），可第一时间拿到最新版本。
• Obtainium：配置一次后自动跟踪 GitHub 发布并提示更新，包名使用io.ente.photos.independent。

包名与多渠道结构（源码视角）

从 mobile/apps/photos/android/app/build.gradle 可以看到，Android 构建通过productFlavors区分各分发渠道，核心包名统一为io.ente.photos，各渠道通过applicationIdSuffix追加后缀：

productFlavors { independent { applicationIdSuffix ".independent" } // GitHub 直装 / Obtainium dev { applicationIdSuffix ".dev" } // 开发版 playstore { /* 无后缀，即 io.ente.photos */ } // Play Store fdroid { applicationIdSuffix ".fdroid" } // F-Droid }

其中independent渠道即 GitHub 直装包与 Obtainium 追踪的包（io.ente.photos.independent），minSdk = 26（Android 8.0），发布版启用minifyEnabled true与 ProGuard 混淆。这就是为什么从 GitHub 下载的 APK 与 Play Store 版本包名不同，且 Play Store / F-Droid 与 GitHub 直装包可能使用不同的签名密钥。

通过 Obtainium 手动配置跟踪 GitHub 发布

点击官方提供的 Obtainium 一键配置链接即可自动添加，也可以手动配置：

1. 打开 Obtainium，点击Add App。
2. 在App Source URL填入https://github.com/ente/ente。
3. 启用Retain release order from API。
4. 在Filter APKs by Regular Expression填入ente-photos*，精确匹配相册 APK。
5. 启用Attempt to filter APKs by CPU architecture（如有该选项）。
6. 按需选择应用分类标签。
7. 启用Try inferring app ID from source code。
8. 点击Add完成配置，此后 Obtainium 会定期检查新版本并提示更新。

校验 GitHub 直装 APK 的签名指纹

从 GitHub 直接下载 APK 属于「旁加载」，建议校验其签名证书是否与 Ente 官方一致。官方的直接下载包签名指纹如下（注意：Play Store 与 F-Droid 包可能使用不同密钥，此指纹仅适用于 GitHub 直装 APK）：

• SHA1：E1:60:10:18:B6:B0:2E:A3:74:6F:90:67:50:30:29:75:0E:EF:6D:39
• SHA256：35:ED:56:81:B7:0B:B3:BD:35:D9:0D:85:6A:F5:69:4C:50:4D:EF:46:AA:D8:3F:77:7B:1C:67:5C:F4:51:35:0B

使用apksigner校验：

apksigner verify --print-certs <path_to_apk>

apksigner输出的指纹为小写且不带冒号，例如：

Signer #1 certificate SHA-256 digest: 35ed5681b70bb3bd35d90d856af5694c504def46aad83f777b1c675cf451350b

将该输出与上述 SHA256 指纹（去除冒号、转小写后）比对一致即可确认 APK 未被篡改。完整步骤可参考 Verify the Ente Photos Android APK。

桌面端：macOS、Windows、Linux

Ente Photos 桌面版基于 Electron 构建（见 desktop/package.json，Electron 42.x + electron-builder），覆盖三大桌面平台，下载对应安装包运行即可：

• macOS：下载 DMG 安装包，拖入 Applications 即可。注意：macOS 版要求 macOS 13.3 或更高版本。
• Windows：下载并运行安装程序，一路下一步即可。
• Linux：提供安装包或 AppImage 格式。

[!NOTE] 桌面版内置自动更新功能（依赖electron-updater），新版本发布后应用会自动下载并安装，无需手动升级。

如果你希望从源码自行构建桌面版（适用于开发或离线环境），官方仓库提供了完整流程：

# 1. 安装 Node 与 Rust 后，安装 web 端依赖 cd web && npm ci # 2. 安装桌面端依赖 cd ../desktop && npm ci # 3. 开发模式运行（renderer 支持热重载） npm run dev

静态构建则依次执行：

npm run postinstall npm run build

从 desktop/package.json 的脚本可以看出，桌面端实际复用了 web 端photos应用的构建产物（build-renderer会构建../web下的 photos 应用并复制到out目录），同时通过codegen:napi调用 Rust 侧 NAPI 代码生成，说明桌面端渲染层与 Web 版同源。若在 Windows 上遇到「JavaScript error occurred in main process」类错误，通常是缺少 VC++ 运行时；Linux AppImage 若图标/文件关联不生效，可参考 桌面端故障排查。

Web 浏览器：无需安装直接使用

Ente Photos 提供 Web 版，无需安装任何软件，直接在浏览器打开 photos.ente.com 并用邮箱密码登录即可使用。Web 版覆盖桌面应用的大部分功能，但不支持机器学习（人脸识别/魔法搜索）与视频流生成。

[!NOTE] 旧的web.ente.io与photos.ente.io地址现已重定向到photos.ente.com，同一个账户与密码继续有效。如果你的密码管理器保存的是旧地址的登录项，可以放心在photos.ente.com使用。

命令行界面（CLI）：面向服务器与自动化

对于服务器环境、定时备份和脚本化工作流，Ente 提供官方 CLI 工具（Go 编写，cobra 命令框架，源码位于 cli，命令文档见 cli/docs/generated/ente.md）。

安装 CLI

• 推荐方式：从官方 Releases 下载预编译二进制（Linux x64/ARM64、macOS Intel/Apple Silicon、Windows x64）。生成的二进制是独立的静态可执行文件，无运行时依赖，可直接运行或放入PATH。
• 从源码构建：

go build -o "bin/ente" main.go

• 一键构建全部平台：

./release.sh

• Docker 方式：修改 cli/docker-compose.yml，cli-data卷为必填，可按需追加导出目录卷；构建镜像需要 BuildKit（如失败可在命令前加DOCKER_BUILDKIT=1）：

docker-compose up -d --build docker-compose exec ente-cli /bin/sh -c "./ente-cli version" docker-compose exec ente-cli /bin/sh -c "./ente-cli account add"

基础用法

# 查看全部命令 ente --help # 添加账户（注意：不会创建新账户，仅登记已有账户以便后续操作） ente account add # 列出已登记账户 ente account list # 为某账户指定导出目录（每账户执行一次） ente account update --app photos --email you@example.com --dir /path/to/backup # 启动导出 ente export # 仅导出指定相册 ente export --albums "Album Name","Another Album"

定时自动备份与 NAS 同步

CLI 的导出是增量式的（只下载新增或变更的文件），可安全中断、随时重启且不会重复下载，同时保留相册结构与元数据，非常适合 crontab 调度：

# 先设置导出目录（在 cron 外执行一次） /usr/local/bin/ente account update --app photos --email you@example.com --dir /nas/ente-backup # 每天凌晨 2 点执行导出 0 2 * * * /usr/local/bin/ente export

在 NAS 上安装 CLI 后，即可通过定时任务将 Ente 中的照片增量拉取到 NAS 实现同步。注意：CLI 目前仅支持单向拉取（Ente → 本地），不支持双向同步，本地文件的修改不会回传 Ente。

导出格式

导出会保留 Ente 中的完整相册结构（每个相册对应一个文件夹），并附带与 Google Takeout 相同格式的元数据 JSON 文件：

photo.jpg .meta/photo.jpg.json

这种兼容格式让依赖 Google Takeout 导入的工具可以直接处理 Ente 的导出结果。更多导出细节见 Export 功能指南。

CLI 与桌面端导出的对比

多设备登录与下一步

安装完成后，用同一账户在任意设备上选择Existing user登录即可，照片会自动跨设备同步；每个设备可独立配置自己的备份范围（手机选择相册、桌面端选择监控文件夹）。登录后建议立即：

1. 确认恢复密钥已妥善保存（端到端加密下这是忘记密码时的唯一恢复手段）；
2. 参考 创建账户与登录指南 完成账户设置；
3. 配置自动备份（见 日常使用指南）。

相关 FAQ

• 在 Android 上安装 Ente Photos：Play Store、F-Droid、GitHub、Obtainium 渠道对比
• 在 iPhone / iPad 上安装：App Store 安装
• 在桌面端安装：Windows / macOS / Linux
• 从浏览器访问：photos.ente.com
• 最新版本为何未上架 F-Droid：构建延迟约 2 周
• 如何手动用 Obtainium 配置安装
• 如何更新到最新版本

【免费下载链接】ente💚 End-to-end encrypted cloud for everything.项目地址: https://gitcode.com/GitHub_Trending/en/ente