kuingsmile/piclist Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Piclist Docker镜像文档

镜像概述

Piclist Docker镜像是基于 piclist-core 项目的容器化部署方案，提供图片上传管理服务的容器化运行环境。该镜像封装了PicGo核心功能，支持通过服务器模式运行，便于快速部署和管理图片上传服务。

核心功能与特性

• 服务器模式运行：支持通过picgo-server启动HTTP服务，提供图片上传接口
• 插件扩展：支持安装PicGo生态插件，扩展上传功能（如第三方存储支持）
• 配置持久化：通过数据卷挂载保存配置文件，避免容器重启后配置丢失
• 灵活定制：支持通过命令行参数自定义访问密钥，通过picgo set修改配置

使用场景

• 个人或团队图片上传服务的容器化部署
• 需要隔离环境运行PicGo服务的场景
• 需便捷管理配置和插件的图片上传工作流

使用方法

Docker Run部署

命令格式

bash
docker run -d \
  --name piclist \
  --restart always \
  -p 36677:36677 \
  -v "./piclist:/root/.piclist" \
  kuingsmile/piclist:latest \
  node /usr/local/bin/picgo-server -k piclist***

参数说明

• -d：后台运行容器
• --name piclist：指定容器名称为piclist
• --restart always：容器退出时自动重启
• -p 36677:36677：映射容器36677端口到宿主机36677端口（PicGo服务器默认端口）
• -v "./piclist:/root/.piclist"：挂载宿主机目录./piclist到容器内/root/.piclist（持久化配置文件）
• kuingsmile/piclist:latest：使用最新版镜像
• node /usr/local/bin/picgo-server -k piclist***：启动命令，-k后为访问密钥（需替换为自定义密钥）

Docker Compose部署

配置文件

创建docker-compose.yml文件，内容如下：

yaml
version: '3.3'

services:
  node:
    image: 'kuingsmile/piclist:latest'
    container_name: piclist
    restart: always
    ports:
      - 36677:36677
    volumes:
      - './piclist:/root/.piclist'
    command: node /usr/local/bin/picgo-server -k piclist***

参数调整

• volumes：修改./piclist为宿主机实际目录，用于持久化配置
• command：修改-k后的piclist***为自定义访问密钥

启动命令

bash
docker-compose up -d

插件安装

通过docker exec进入容器后执行插件安装命令：

1. 进入容器终端：

   bash
   docker exec -it piclist sh
   

2. 安装插件（替换picgo-plugin-xxx为实际插件名称）：

   bash
   picgo install picgo-plugin-xxx
   

配置修改

通过docker exec进入容器后修改配置：

1. 进入容器终端：

   bash
   docker exec -it piclist sh
   

2. 修改配置（替换xxx为配置项）：

   bash
   picgo set xxx
   

配置修改后需重启容器生效：

bash
docker restart piclist

注意事项

• 数据卷./piclist需确保宿主机目录存在且有读写权限，避免配置丢失
• 访问密钥-k需设置高强度值，保障服务访问安全
• 插件安装和配置修改后建议重启容器，确保生效