通用收藏管理器Koillection

news2025/10/26 21:44:36

在这里插入图片描述

什么是 Koillection ？

Koillection 是一个自托管的收藏管理器，旨在跟踪任何类型的物理（主要）收藏，如书籍、DVD、邮票、游戏……，由于 Koillection 旨在用于任何类型的收藏，它不支持自动下载元数据。但它提供了自由添加您自己的元数据的可能性。

安装

在群晖上以 Docker 方式安装。

本文写作时， latest 版本对应为 1.4.6；

docker cli 安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 koillection 和 子目录
mkdir -p /volume1/docker/koillection/{data,uploads,web}

# 进入 koillection 目录
cd /volume1/docker/koillection

# 修改目录权限
chmod 666 uploads

# 运行 postgresql 容器
docker run -d \
   --restart always \
   --name koillection-db \
   -v $(pwd)/data:/var/lib/postgresql/data \
   -e POSTGRES_DB=koillection \
   -e POSTGRES_USER=postgres \
   -e POSTGRES_PASSWORD=password \
   postgres:15

# 运行 koillection 容器
docker run -d \
   --restart always \
   --name koillection-web \
   --link koillection-db:postgresql \
   -p 4081:80 \
   -v $(pwd)/uploads:/var/www/koillection/public/uploads \
   -e APP_ENV=dev \
   -e APP_DEBUG=1 \
   -e DB_DRIVER=pdo_pgsql \
   -e DB_NAME=koillection \
   -e DB_HOST=postgresql \
   -e DB_PORT=5432 \
   -e DB_USER=postgres \
   -e DB_PASSWORD=password \
   -e DB_VERSION=15 \
   -e PHP_TZ=Asia/Shanghai \
   -e HTTPS_ENABLED=0 \
   koillection/koillection:latest

目录 uploads 需要写入权限，否则上传可能会遇到错误

在这里插入图片描述

docker-compose 安装

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: '3'

services:
    koillection:
        image: koillection/koillection:latest
        container_name: koillection-web
        restart: always
        ports:
            - 4081:80
        volumes:
            - ./uploads:/var/www/koillection/public/uploads
        environment:
            - APP_ENV=dev
            - APP_DEBUG=1
            - DB_DRIVER=pdo_pgsql
            - DB_NAME=koillection
            - DB_HOST=postgresql
            - DB_PORT=5432
            - DB_USER=postgres
            - DB_PASSWORD=password
            - DB_VERSION=15
            - PHP_TZ=Asia/Shanghai
            - HTTPS_ENABLED=0
        depends_on:
            - postgresql
            
    postgresql:
        image: postgres:15
        container_name: koillection-db
        restart: always
        volumes:
            - ./data:/var/lib/postgresql/data
        environment:
            - POSTGRES_DB=koillection
            - POSTGRES_USER=postgres
            - POSTGRES_PASSWORD=password

然后执行下面的命令

# 新建文件夹 koillection 和 子目录
mkdir -p /volume1/docker/koillection/{data,uploads,web}

# 进入 koillection 目录
cd /volume1/docker/koillection

# 修改目录权限
chmod 666 uploads

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d