


>简介：通过Docker部署PicGo Server版，实现一次配置、随处可用的高效图片管理方案。本文详细介绍了从构建自定义镜像到启动容器的完整流程，涵盖插件安装、图床配置等关键步骤，并特别提醒了安全注意事项。这一部署方式解决了多设备间配置不同步的痛点，让用户在公司、家庭等多场景下都能使用统一的图床服务，真正做到上传记录集中管理、配置云端同步。无论是个人创作者还是团队协作，都能通过Docker化部署获得更灵活、稳定的图片上传体验。

在前面的文章中，我们详细介绍了 PicGo 的各种强大功能。不过，许多用户在实际使用中会遇到一个共同的痛点：每台电脑都需要单独配置，对于经常在多台设备间切换的用户来说，确实不够方便。

今天，我将分享如何通过 Docker 在服务器上部署 PicGo 的 Server 版本，实现“一次配置，随处上传”，彻底解决多设备同步难题。


![](https://developer.qcloudimg.com/http-save/yehe-9735680/9024518ee09a13b591011ed88873cdbf.png)


## 🐳 Docker 部署实战

### 🛠️ 构建自定义镜像

我选择 `node:22.11.0-alpine` 作为基础镜像进行构建，以下为完整的 Dockerfile 内容：

```dockerfile
# 使用轻量级 Node.js 镜像
FROM node:22.11.0-alpine
# 维护者信息
LABEL maintainer="xj"
# 全局安装 PicGo
RUN npm install picgo -g
# 暴露容器 HTTP 端口
EXPOSE 36677
# 设置容器启动命令
CMD ["picgo", "server", "--host", "0.0.0.0", "--port", "36677"]
```

构建镜像：

```bash
docker build -t xj/picgo:2.0.0 .
```

镜像构建完成后，我已将其上传至阿里云镜像仓库。你也可以直接使用该镜像：
`registry.cn-hangzhou.aliyuncs.com/xjpublic/picgo:2.0.0`

### ⚙️ 启动容器

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

```yaml
services:
  picgo:
    # 可替换为阿里云镜像：registry.cn-hangzhou.aliyuncs.com/xjpublic/picgo:2.0.0
    image: xj/picgo:2.0.0
    container_name: picgo
    restart: unless-stopped
    ports:
      - "36677:36677"
    volumes:
      - ./data:/root/.picgo  # 挂载配置文件、插件等数据
```

在 `docker-compose.yml` 同级目录下执行以下命令启动容器：

```shell
docker-compose up -d
```

至此，PicGo 服务已成功启动。

### 🧩 插件下载与配置

服务启动后，我们需要进入容器内部下载并配置插件。执行以下命令进入容器：

```shell
docker exec -it <container_id> /bin/sh
```

使用 `picgo -v` 查看 PicGo 版本，也可通过 `picgo help` 查看更多命令用法。

![](https://developer.qcloudimg.com/http-save/yehe-9735680/34f2d4ced735124b1b20e9654e37c63c.png)

以我使用的 Chevereto 图床为例，我下载了两个插件：Chevereto 上传插件和文件重命名插件 `hashname`。具体操作如下：

```shell
# 下载 Chevereto 插件
picgo install chevereto
# 选择插件
picgo use plugins
# 设置上传器为 Chevereto
picgo set uploader chevereto
# 将 Chevereto 设为主图床
picgo use uploader chevereto
```

![](https://developer.qcloudimg.com/http-save/yehe-9735680/6afcbf4d5ee1bea60dc7ca2b1e7ad055.png)

配置完成后，重启容器以使配置生效：

```shell
docker-compose restart
```

现在，你就可以在 Postman 或其他第三方工具中，通过配置 PicGo 服务地址来使用图床功能了。

![](https://developer.qcloudimg.com/http-save/yehe-9735680/890270ccc2c76c4670e6e7272c214004.png)

![](https://developer.qcloudimg.com/http-save/yehe-9735680/cf9f61a66b81b33bc1940de2cf316286.png)

若需启用文件重命名功能，可配置 `hashname` 插件：

```shell
# 下载 Hashname 插件
picgo install hashname
# 启用插件作为 Transformer
picgo use transformer hashname
```

![](https://developer.qcloudimg.com/http-save/yehe-9735680/c94078b96b9b0d605d62f3661a394dfb.png)

至此，基于 Docker 的 PicGo 服务部署与基础配置已全部完成。

## 🚨 安全注意事项

1. **请勿在公网直接暴露服务**：除非仅用于临时测试，否则务必配置身份验证。
2. **定期更新镜像**：确保获得最新的安全修复与功能优化。
3. **限制访问 IP**：若仅在内部网络使用，建议设置 IP 白名单。
4. **定期备份配置**：避免因意外导致配置丢失。

## 🎉 总结

通过 Docker 部署 PicGo Server 版，我们彻底解决了多设备配置同步的痛点。现在，无论是在公司的办公电脑，还是家里的个人笔记本，只需访问统一的 PicGo 服务地址，即可实现：

- **统一配置**：所有设备共用一套图床与插件设置。
- **集中管理**：上传历史与图片库集中存储，便于查找与管理。


无论是个人创作还是团队协作，Docker 化部署让 PicGo 的使用变得更加灵活、稳定与高效。现在就动手部署属于你自己的 PicGo 服务吧！



简介：通过Docker部署PicGo Server版，实现一次配置、随处可用的高效图片管理方案。本文详细介绍了从构建自定义镜像到启动容器的完整流程，涵盖插件安装、图床配置等关键步骤，并特别提醒了安全注意事项。这一部署方式解决了多设备间配置不同步的痛点，让用户在公司、家庭等多场景下都能使用统一的图床服务，真正做到上传记录集中管理、配置云端同步。无论是个人创作者还是团队协作，都能通过Docker化部署获得更灵活、稳定的图片上传体验。

Docker 部署 PicGo：一次配置,随处使用

通过Docker部署PicGo Server版，实现一次配置、随处可用的高效图片管理方案。本文详细介绍了从构建自定义镜像到启动容器的完整流程，涵盖插件安装、图床配置等关键步骤，并特别提醒了安全注意事项。这一部署方式解决了多设备间配置不同步的痛点，让用户在公司、家庭等多场景下都能使用统一的图床服务，真正做到上传记录集中管理、配置云端同步。无论是个人创作者还是团队协作，都能通过Docker化部署获得更

编程语言

开发工具

Docker部署PicGoServer版教程：详细讲解从镜像构建到容器启动的全流程，解决多设备配置同步难题。包含插件安装、图床配置等关键步骤，特别强调安全注意事项。实现一次配置随处可用，统一管理上传记录，提升个人创作和团队协作效率。

身份验证

服务器

容器

Docker

2026新春采购季

4核4G3M云服务器 新用户低至38元/年！

人脸核身+人脸识别特惠活动0.6折起


faceid

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Docker 部署 PicGo：一次配置,随处使用-腾讯云开发者社区-腾讯云

Docker 部署 PicGo：一次配置,随处使用

Docker 部署 PicGo：一次配置,随处使用

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐