North

Recent Progress

1. 用户登录授权系统

   

2. 全新风格 UI

   

3. 插件化开发

   

   

4. 其他

   • 支持 docker 部署
   • 可视化安装、迁移
   • 支持用户组策略、图片权限设置
   • 多数据库支持（MySql、SQL Server、Oracle、Sqlite、PostgreSQL、……）
   • ……

Background

图床可以把图片转为链接，从而方便我们书写、分享博客，目前图床主要分为以下几类

• 利用 Git 仓库存储
• 对象存储（OSS、COS、七牛云等）
• 免费公共图床（SM.MS、聚合图床、ImgTP、Postimage等）

但上述图床都有些不尽人意

• 公共图床的稳定性未知，往往会开启审查机制、限制上传图片的尺寸
• Github 国内访问速度堪忧，并且官方明令禁止将 Github 和 Gitee 仓库作为图床
• 对象存储的容量和访问速度还不错，但流量较贵

图床服务并不需要高性能的服务器去承载，现在云服务器的价格也并不昂贵，因此搭建个人图床也许是不错的选择。出于这样的想法，作者设计了 ImageBed 以供大家快速搭建个人图床服务。

Feature

• 剪贴板图片上传、链接自动复制
• 可视化图片管理
• 安全可靠，图片完全存储在主机
• 无图片尺寸、数量、带宽限制（取决于环境）
• 跨平台，可在 windows、Linux、MacOS 部署

Install

Requirement

• .NET Runtime (必需)
  • 在 Windows 上安装
  • 在 Linux 上安装 .NET
  • 在 macOS 上安装 .NET
• Nginx (可选)

All Release

在这里可快速选择适合自己的版本，表格中的格式为 "最小版本/ 推荐版本"

功 能	ImageBed 版本	picgo-plugin-imagebed版本
图片上传与下载	v1.0.0 / v1.1.4	v1.1.1
图库管理	v2.0.0 / v2.2.13
自动更新	v2.3.14 / v2.3.14

本地搭建

版本: Windows 11 家庭中文版 (21H2)

1. 前往 ImageBed主页 下载资源包

   

2. 解压资源包 (图片存储路径为 Data/Resources/Images)

   

3. 双击 ImageBed.exe 运行服务

   

4. 浏览器地址栏输入 localhost:12121

   

5. 点击上传图片

   

   

6. 安装完成

云服务器搭建

版本: Ubuntu 18.04.4 LTS（GNU/Linux 4.15.0-159-generic x86_64）

1. 将资源包解压后上传至云服务器

   

2. 进入 ImageBed 文件夹，运行 ImageBed.dll

   nohup dotnet ImageBed.dll &

   该命令会在后台运行 ImageBed.dll，若要关闭 ImageBed 服务，需要先查询 ImageBed 服务的 pid，之后用 kill 命令关闭

   # 查询ImageBed服务pid
   ps -ef | grep dotnet
   
   # pid为4363
   ubuntu    4363  1636  0 19:32 pts/0    00:00:01 dotnet ImageBed.dll
   ubuntu   31389 30239  0 21:47 pts/2    00:00:00 grep --color=auto dotnet
   
   # 关闭ImageBed服务
   ubuntu@VM-0-16-ubuntu:~$ sudo kill 4363

3. 浏览器地址栏输入 {ip}:12121 即可访问图床服务，其中 {ip} 为云服务器公网 ip

4. 安装完成

Nginx 反向代理

反向代理概念、原理、功能请 移步，这里不再赘述。下面主要叙述如何在 Linux 上搭建 Nginx 反相代理

1. 安装 nginx

   sudo apt-get install nginx

2. 打开 /etc/nginx/nginx.conf，修改相关设置

   user www-data;
   worker_processes auto;
   pid /run/nginx.pid;
   include /etc/nginx/modules-enabled/*.conf;
   
   events {
   	  worker_connections 768;
   }
   
   http {
      sendfile on;
      tcp_nopush on;
      tcp_nodelay on;
      keepalive_timeout 65;
      types_hash_max_size 20480;
   
      include /etc/nginx/mime.types;
      default_type application/octet-stream;
   
      ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # Dropping SSLv3, ref: POODLE
      ssl_prefer_server_ciphers on;
   
      access_log /var/log/nginx/access.log;
      error_log /var/log/nginx/error.log;
   
      gzip on;
   
      map $http_connection $connection_upgrade {
        "~*Upgrade" $http_connection;
        default keep-alive;
      }
   
      # ========================== 重点看这里========================
      server {
          listen 80;
          server_name xxx.xxx.xxx.xxx;				                    # 云服务器公网ip (或域名)     
   
          location / {
              client_max_body_size 100m;                          		# html报文尺寸限制
              
              proxy_pass http://127.0.0.1:12121;
   
              # Configuration for WebSockets
              proxy_set_header Upgrade $http_upgrade;
                    proxy_set_header Connection $connection_upgrade;
                    proxy_cache off;
               # WebSockets were implemented after http/1.0
              proxy_http_version 1.1;
   
              # Configuration for ServerSentEvents
              proxy_buffering off;
   
              # Configuration for LongPolling or if your KeepAliveInterval is longer than 60 seconds
              proxy_read_timeout 100s;
   
              proxy_set_header Host $host;
              proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
              proxy_set_header X-Forwarded-Proto $scheme;
          }
      }
   
   	  include /etc/nginx/conf.d/*.conf;
   	  include /etc/nginx/sites-enabled/*;
   }

3. 检查 nginx.conf 语法是否正确

   sudo nginx -t

   若格式正确则输出

   nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
   nginx: configuration file /etc/nginx/nginx.conf test is successful

4. 关闭防火墙并重新加载 nginx

   sudo systemctl stop firewalld
   sudo systemctl start girewalld
   sudo firewall-cmd --reload
   sudo nginx -s reload

Usage

上传

web 界面上传

剪贴板上传

删除

导入导出

导入图片

导出图片

视图切换

API

该图床服务器包含三个API（上传、下载、删除），控制器为 Controllers/ImageController

上传图片

HTTP POST /api/image

Body 请求参数 Form-data

参数名	类型	必填	说明
*	[file]	是	图片文件

返回参数 JSON 最外层结构为: Object

参数名	类型	必含	说明
statusCode	[int]	是	状态码
message	[string]	是	提示信息
res	[array]	是	图片链接

下载图片

HTTP GET /api/image/{imageName}

REST参数

参数名	类型	必填	说明
imageName	[string]	是	图片名称

返回参数 Binary

图片文件

删除图片

HTTP DELETE /api/image/{imageName}

REST参数

参数名	类型	必填	说明
imageName	[string]	是	图片名称

返回参数 JSON 最外层结构为: Object

参数名	类型	必含	说明
statusCode	[int]	是	状态码
message	[string]	是	提示信息
res	[object]	是	恒为null

Q & A

S1. 局域网用户如何上传图片？

局域网内用户在浏览器输入 {ip}:12121 即可访问图床服务器，其中 {ip} 为服务器的 局域网IP

S2. 如何对接Picgo?

PicGo 是一款图床管理软件，支持多种图床。使用 picgo 可大大简化我们上传图片的流程，笔者在此开发了 picgo 插件 picgo-plugin-imagebed 以供大家使用

S3. 导入图片压缩包无响应？

请尝试直接压缩图片，而不是包含图片的文件夹

S4. 通知设置中的邮箱授权码如何获取？

请移步 这里