高性能自托管照片和视频管理解决方案

免责声明

• ⚠️ 该项目正在非常活跃的开发中。
• ⚠️ 预计可能会出现错误和重大更改。
• ⚠️ 请勿将本应用作为存储照片和视频的唯一方式。
• ⚠️ 请始终遵循 3-2-1 备份计划来保护您珍贵的照片和视频！

[!注意]
您可以在 https://immich.app/ 找到主要文档，包括安装指南。

链接

• 文档
• 关于
• 安装
• 路线图
• 演示
• 功能
• 翻译
• 贡献

演示

此处 访问演示。对于移动应用，您可以使用“https://demo.immich.app”作为“服务器端点 URL”。

登录凭证

功能

安装 - Docker Compose [推荐]

Docker Compose 是生产环境中运行 Immich 的推荐方法。以下是使用 Docker Compose 部署 Immich 的步骤。

步骤 1 - 下载所需

创建您选择的目录（例如./immich-app）来保存docker-compose.yml和.env文件。

kdir ./immich-app
cd ./immich-app

下载docker-compose.yml和example.env文件：

wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml

wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

您也可以从浏览器下载这两个文件并将它们移动到您创建的目录中，在这种情况下，请确保将其重命名example.env为.env。

步骤 2 - 使用自定义

# You can find documentation for all the supported env variables at https://immich.app/docs/install/environment-variables

# The location where your uploaded files are stored
UPLOAD_LOCATION=./library

# The location where your database files are stored. Network shares are not supported for the database
DB_DATA_LOCATION=./postgres

# To set a timezone, uncomment the next line and change Etc/UTC to a TZ identifier from this list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
# TZ=Etc/UTC

# The Immich version to use. You can pin this to a specific version like "v1.71.0"
IMMICH_VERSION=release

# Connection secret for postgres. You should change it to a random password
# Please use only the characters `A-Za-z0-9`, without special characters or spaces
DB_PASSWORD=postgres

# The values below this line do not need to be changed
###################################################################################
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

• 填写UPLOAD_LOCATION您存储备份资产的首选位置。它应该是服务器上一个具有足够可用空间的新目录。
• 考虑更改DB_PASSWORD为自定义值。Postgres 不公开，因此此密码仅用于本地身份验证。为了避免 Docker 解析此值时出现问题，最好仅使用字符A-Za-z0-9. ，pwgen这是一个方便的实用程序。
• 通过取消注释该TZ=行来设置您的时区。
• 如果需要，填充自定义数据库信息。

步骤 3 - 启动

从您在步骤 1 中创建的目录（现在应该包含您的自定义docker-compose.yml文件.env）中，运行以下命令以启动 Immich 作为后台服务：

docker compose up -d

Docker 版本
如果您遇到类似unknown shorthand flag: 'd' in -d或 的错误open <location of your .env file>: permission denied，则可能是您运行的 Docker 版本错误。（例如，Ubuntu 22.04.3 LTS 中的 docker.io 软件包就会出现这种情况。）您可以按照您发行版的完整Docker Engine 安装步骤来解决问题，尤其是“卸载旧版本”和“使用 apt/rpm 仓库安装”部分。这些步骤会将发行版的 Docker 软件包替换为 Docker 官方软件包。

请注意，正确的命令实际上是docker compose，而不是docker-compose。如果您在 vanilla Ubuntu 22.04 上尝试后者，它将以不同的方式失败：
The Compose file './docker-compose.yml' is invalid because:
'name' does not match any of the regexes: '^x-'
请参阅上一段有关从官方 Docker 存储库安装的内容。

健康检查启动间隔
如果出现错误can't set healthcheck.start_interval as feature require Docker Engine v25 or later，则有助于注释掉文件部分start_interval中的行。databasedocker-compose.yml

仓库活跃度

Star history