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: docker.xuanyuan.run/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%EF%BC%8C%E5%B9%B6%E6%8C%89%E7%85%A7%E9%A1%B5%E9%9D%A2%E6%8C%87%E7%A4%BA%E5%AE%8C%E6%88%90%E5%88%9D%E5%A7%8B%E8%AE%BE%E7%BD%AE%E3%80%82

从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%EF%BC%8C%E6%8C%89%E7%85%A7%E8%BF%81%E7%A7%BB%E6%8C%87%E7%A4%BA%E6%93%8D%E4%BD%9C%EF%BC%88%E9%9C%80%E8%BF%81%E7%A7%BB%E7%9A%84%E5%9B%BE%E4%B9%A6%E9%A6%86%E6%96%87%E4%BB%B6%E5%A4%B9%E8%B7%AF%E5%BE%84%E4%B8%BA%60/app/library%60%EF%BC%89%E3%80%82

更新

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

bash
docker-compose down
docker-compose up -d

故障排除

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