cgrima/i-librarian

I, Librarian Docker镜像文档

镜像概述和主要用途

本镜像用于部署I, Librarian——一个免费开源的Web应用程序，旨在帮助用户构建和管理科学图书馆。通过Docker容器化部署，可简化安装流程并确保环境一致性。

先决条件

若尚未拥有I, Librarian数据库，需在主机上创建空白的图书馆文件夹${DATA_PATH}以初始化图书馆，并正确设置其所有权：

bash
mkdir ${DATA_PATH}
sudo chown 33:33 ${DATA_PATH}

运行容器

命令行

使用以下命令直接运行容器：

bash
sudo docker run -d -p 8080:80 \
            -v ${DATA_PATH}:/app/data \
            -v /etc/localtime:/etc/localtime:ro \
            --name=i-librarian \
            cgrima/i-librarian

Docker Compose

创建docker-compose.yml文件：

yaml
version: "2"

services:
  app:
    image: cgrima/i-librarian
    privileged: true
    ports:
      - "8080:80"
    volumes:
      - ${DATA_PATH}:/app/data
      - /etc/localtime:/etc/localtime:ro

启动容器：

bash
docker-compose up -d

访问I, Librarian实例

在Web浏览器中打开http://localhost:8080，并按照页面指示完成初始设置。

从I, Librarian 4.10迁移到5.*版本

注意：4.10版本的数据库文件夹名为library，5.*版本中更名为data。

迁移步骤：

1. 停止4.10版本的I, Librarian容器，例如：docker-compose stop i-librarian
2. 备份4.10版本的library/文件夹。
3. 删除4.10版本的I, Librarian容器，例如：docker-compose rm i-librarian
4. 从最新源码重建I, Librarian镜像，例如：docker-compose up -d
5. 按照上述步骤之一构建并启动新的5.*版本容器，同时添加原4.10版本的数据库文件夹作为卷，例如：-v ${LIBRARY_PATH}:/app/library
6. 访问http://localhost:8080，按照迁移指示操作（需迁移的图书馆文件夹路径为/app/library）。

更新

停止、删除并重新启动容器即可完成更新。使用Docker Compose：

bash
docker-compose down
docker-compose up -d

故障排除

若图书馆文件夹存在权限问题，尝试在docker run命令中添加--privileged=true选项。