【Docker项目实战】使用Docker搭建Picsur图床服务

一、Picsur介绍

1.1 Picsur简介

Picsur是一款类似Imgur的自托管图片分享服务，内置强大的图片转换与编辑功能，确保用户能够轻松管理个人或团队的图像资源。

1.2 主要特点

  • 图片上传与查看：支持匿名及注册用户上传和查看图片。
  • 用户账户系统：提供用户账号创建，方便个性化管理和隐私保护。
  • 角色与权限管理：具备灵活的用户角色和权限设定，便于多用户环境下的管理。
  • 安全的跨域资源共享(CORS)：实施适当的CORS策略，保障数据安全。
  • 元数据清理：自动移除图片中的EXIF信息，保护用户隐私。
  • 原图保存选项：允许用户选择是否保留原始图片文件。
  • 多格式支持：兼容QOI、JPG、PNG、WEBP(含动画)、TIFF、BMP、GIF(含动画)等多种图像格式。
  • 图片转换功能：提供图片转换选项，如调整尺寸、旋转、翻转、去除透明度、负片效果及灰度化处理。
  • 图片删除功能：用户可以删除不再需要的图片，保持账户整洁。
  • 数据库迁移支持：确保软件升级时数据平滑迁移，无后顾之忧。
  • 个人图片列表：用户可以轻松查看自己上传的所有图片。
  • 聊天应用预览优化：优化图片在各类聊天应用中的预览效果，提升用户体验。
  • 图片过期机制：支持设置图片的有效期限，到期自动删除。
  • ShareX集成：提供ShareX插件支持，方便快捷地上传图片。
  • 多架构Docker镜像：为ARM64和AMD64架构提供Docker镜像，便于不同平台的部署。

二、本次环境规划

2.1 本次实践简介

1.本次实践为个人测试学习环境，旨在新手快速上云和部署应用，生产环境请谨慎；
2.本次实践环境为腾讯云轻量应用服务器，在Docker环境下部署Picsur图床工具。

2.2 本次环境规划

  • 本次实践的环境规划如下：
云厂商云产品应用模版操作系统版本Docker版本部署项目容器镜像名称
腾讯云轻量应用服务器Docker CECentos 726.1.3Picsur图床工具ghcr.io/caramelfur/picsur:latest

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

[root@VM-8-9-centos ~]# systemctl status docker
● docker.service - Docker Application Container Engine
   Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
   Active: active (running) since Thu 2025-01-09 20:59:40 CST; 4 days ago
     Docs: https://docs.docker.com
 Main PID: 1424 (dockerd)
    Tasks: 9
   Memory: 1.0G
   CGroup: /system.slice/docker.service
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.

3.2 检查Docker版本

检查Docker版本

[root@VM-8-9-centos ~]# docker -v
Docker version 26.1.3, build b72abbb
  • 1.
  • 2.

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

[root@VM-8-9-centos ~]# docker compose version
Docker Compose version v2.27.1
  • 1.
  • 2.
  • 3.

四、部署Picsur图床应用

4.1 下载Picsur镜像

我们执行以下命令，拉取Picsur容器镜像。

[root@VM-8-13-centos ~]# docker pull ghcr.io/caramelfur/picsur:latest
latest: Pulling from caramelfur/picsur
43c4264eed91: Pull complete
65e1b46b2b03: Pull complete
9b2c43f8e8e6: Pull complete
4daa6557aeb9: Pull complete
222f15b4c73b: Pull complete
322b27558ba5: Pull complete
d5c5383f704f: Pull complete
Digest: sha256:209ce21d338cd7d9a1adc838a67695e903149359bf192359819607df1b3c4417
Status: Downloaded newer image for ghcr.io/caramelfur/picsur:latest
ghcr.io/caramelfur/picsur:latest
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.

4.2 创建部署目录

  • 创建Picsur容器的部署目录/data/picsur
mkdir -p /data/picsur/data  && cd  /data/picsur/
  • 1.

4.3 创建Picsur容器

本次实践使用docker compose方式部署，docker-compose.yaml部署文件内容如下：

vim docker-compose.yaml
  • 1.
version: '3'

services:
  picsur:
    image: ghcr.io/caramelfur/picsur:latest
    container_name: picsur
    restart: always
    ports:
      - '9200:8080'
    environment:
      PICSUR_HOST: '0.0.0.0'
      PICSUR_PORT: 8080
      PICSUR_DB_HOST: picsur_postgres
      PICSUR_DB_PORT: 5432
      PICSUR_DB_USERNAME: picsur
      PICSUR_DB_PASSWORD: picsur
      PICSUR_DB_DATABASE: picsur
      PICSUR_MAX_FILE_SIZE: 128000000


  picsur_postgres:
    image: postgres:14-alpine
    container_name: picsur_postgres
    restart: always
    volumes:
      - /data/picsur/data:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: picsur
      POSTGRES_PASSWORD: picsur
      POSTGRES_USER: picsur
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 执行以下命令，创建Picsur容器。
docker compose up -d
  • 1.

【Docker项目实战】使用Docker搭建Picsur图床服务_插入图片

4.4 查看Picsur容器状态

检查Picsur容器状态，确保Picsur正常启动。

[root@VM-8-13-centos picsur]# docker compose ps
WARN[0000] /data/picsur/docker-compose.yaml: `version` is obsolete
NAME              IMAGE                              COMMAND                  SERVICE           CREATED         STATUS      PORTS
picsur            ghcr.io/caramelfur/picsur:latest   "docker-entrypoint.s…"   picsur            2 minutes ago   Up 2 minutes   0.0.0.0:9200->8080/tcp, :::9200->8080/tcp
picsur_postgres   postgres:14-alpine                 "docker-entrypoint.s…"   picsur_postgres   2 minutes ago   Up 2 minutes   5432/tcp
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.

4.5 查看Picsur容器日志

检查Picsur容器日志，确保Picsur服务正常运行。

docker compose logs
  • 1.

【Docker项目实战】使用Docker搭建Picsur图床服务_插入图片_02

五、访问Picsur服务

5.1 访问Picsur初始页

访问地址http://弹性公网IP地址9200，将IP地址替换为自己服务器的弹性公网IP地址。此时，我们可以正常Picsur的初始页，如果无法访问到此页面，请检查本地服务器防护墙是否关闭或放行相关端口。注意，在云服务器部署时，还需要设置安全组规则，放行相关服务端口。

【Docker项目实战】使用Docker搭建Picsur图床服务_插入图片_03

5.2 登录 Picsur

点击右上角的“Login”按钮，使用默认用户名admin和在部署文件环境变量PICSUR_ADMIN_PASSWORD中设置的密码登录，这里设置的登录密码为picsur，确认登录即可。

【Docker项目实战】使用Docker搭建Picsur图床服务_插入图片_04

【Docker项目实战】使用Docker搭建Picsur图床服务_插入图片_05【Docker项目实战】使用Docker搭建Picsur图床服务_docker_06

六、Picsur的基本使用

6.1 上传本地图片

点击Picsur主页的“Upload Image”，上传本地图片。

【Docker项目实战】使用Docker搭建Picsur图床服务_插入图片_07

【Docker项目实战】使用Docker搭建Picsur图床服务_Docker_08

6.2 查看图片列表

在右上角，选择“My Images”，可以看到图片列表。

【Docker项目实战】使用Docker搭建Picsur图床服务_插入图片_09

6.3 分享图片

点开图片预览，可以看到图片的分享链接，其中包括markdown等嵌入代码。

【Docker项目实战】使用Docker搭建Picsur图床服务_docker_10

在其他浏览器打开图片分享的链接，可以正常浏览图片。【Docker项目实战】使用Docker搭建Picsur图床服务_插入图片_11

七、总结

通过本次实战，我们成功使用Docker快速部署了Picsur图床服务，展现了Docker在简化环境配置和提升部署效率方面的优势。整个过程操作简便，无需手动安装复杂依赖，只需几条命令即可完成服务的搭建与运行。通过浏览器访问Picsur界面，用户可以轻松实现图片上传与管理，非常适合用于个人或小型团队的图床需求。