Home

Awesome

PicUploader

PicUploader-logo.png

PicUploader 是一个用php编写的图床工具，它能帮助你快速上传你的图片到云图床，并自动返回Markdown格式链接到剪贴板。配置完成后，要获取一个可用于markdown的图片外链只需要：

主要功能

功能演示

Mac右击图片上传演示、Mac快捷键上传截图演示、Win10右击图片上传演示、Win10快捷键上传截图演示
Win7右击图片上传演示、Win7快捷键上传截图演示、Web版多种上传方式演示、上传任意格式文件演示
MWeb上传图片演示、ShareX使用演示、查看上传记录演示

获取各图床的参数

参见：PicUploader: 各图床获取上传图片参数的方法。

在Mac上配置

本文档为纯文字文档，如有不懂的，请看详细文档：PicUploader: 一个还不错的图床工具(如果网站进不去，先试试用手机流量能不能进，能的话就是你所在地或者所用的那个网络运营商网络对我网站所使用的cdn不通，但一般过几天或者一周两周，又会自动可以，在这之前暂时只能使用代理工具加个pac进去了)。

下载

git clone https://github.com/xiebruce/PicUploader.git

更新

如果以后要更新，请直接从git更新即可：

git pull

填写配置

配置文件方式 把PicUploader/config/config.php文件复制一份，命名为config-local.php，然后在config-local.php中填写配置。

Web方式 直接修改配置虽然可以修改配置，但最好还是配置好下边的web后台，在web页面上修改配置，有界面更方便。

在Mac上搭建web后台

请搭建php+nginx运行环境，以下是nginx配置：

server {
    listen 443 ssl;
    server_name api.picuploader.com;

    client_header_timeout 60s;
    client_body_timeout 60s;
    send_timeout 60s;
    keepalive_timeout  65s;

    access_log /usr/local/var/log/nginx/api.picuploader.com.access.log combined;
    error_log /usr/local/var/log/nginx/api.picuploader.com.error.log error;

    root /Users/bruce/www/personal/PicUploader;

    #https start
    ssl_certificate /Users/bruce/www/personal/PicUploader/accessorys/mkcert/api.picuploader.com.pem;
    ssl_certificate_key /Users/bruce/www/personal/PicUploader/accessorys/mkcert/api.picuploader.com-key.pem;
    ssl_session_timeout 5m;
    ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHellA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
    ssl_prefer_server_ciphers on;
    add_header Strict-Transport-Security "max-age=63072000; includeSubdomains; preload";
    #https end

    location / {
        index dashboard.php;
        try_files $uri $uri/ index.php$is_args$args;
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        include fastcgi.conf;
    }
}

其中ssl_certificate和ssl_certificate_key是证书和证书密钥文件，生成方式请查看：使用mkcert配置本地https。

由于是本地随意写的域名，所以需要在/etc/hosts中指定一下这是本地域名：

127.0.0.1 api.picuploader.com

如果一切正常，访问https://api.picuploader.com就能看到PicUploader后台了，然后你就可以在里面添加配置和上传文件了。

添加右键上传

在Mac启动台中的“实用工具(Utility)”里找到“自动操作(Automator)”，打开它，创建一个服务，输入“shell”搜索→搜索出“运行Shell脚本”→把它拖到右侧：

运行Shell脚本：

export LC_CTYPE="zh_CN.UTF-8"
/usr/bin/php /path/to/PicUploader/index.php "$@" | pbcopy

最后cmd+s保存→命名成Upload with PicUploader就完成了，可以关掉“自动操作”app了，然去Finder随便右击一个文件，是不是有个菜单叫Upload with PicUploader? 点击它就可以上传该文件了。

快捷键上传

安装pngpaste(很小，只有40k左右)

brew install pngpaste

安装Alfred，双击PicUploader/accessorys/PicUploaderHelper/PicUploaderHelper.alfredworkflow→导入。

导入后可看到三个图标:

/usr/local/bin/php /path/to/personal/PicUploader/index.php --type=alfred

使用： 把鼠标光标置于任意编辑器界面上，截图→复制到剪贴板→按快捷键→右上角提示上传中→右上角提示上传完成(此时返回的链接已经自动粘贴到编辑器中)！

作为MWeb图片上传接口

Mweb→Preferences(偏好设置)→Publishing(发布)→Custom(自定义)：

如果你是远程部署的，一定要Nginx添加密码认证，添加了认证，MWeb这里就需要添加一个Header，名称为authorization，值为Basic xxxxxxx，其中xxxxxxx这串值，需要你登录网页版后，在网页控制台→网络→找到任意一个链接→查看它的Request Headers，找到authorization就有这串值。

使用： 截图粘贴到MWeb(或直接拖动图片到MWeb)→点击顶部菜单栏中的Publish→Upload Local Images To...→Copy Markdown即可自动上传图片，等所有图片上传完成，会显示Copied，然后你可以cmd+a全选文章cmd+v粘贴覆盖掉原文，这时整篇文章中的图片都换成了线上链接了。

作为Typora图片上传接口

作为Typora图片上传接口时，必须把PicUploader安装在本地，因为Typora本身不支持上传到api。

Typora→偏好设置→图像→上传服务选Custom Command，自定义命令填(注意把路径换成你电脑上的路径)：

/usr/local/bin/php /path/to/PicUploader/index.php --type=typora

使用： 截图粘贴(或拖动图片)到Typora→Typora自动显示出上传图片菜单(没有显示就右击图片)→点击上传图片，稍等片刻，如果图片上传正常，则图片会自动被替换为返回的图片地址。

作为PicGo自定义图床

右击顶部PicGo图标→打开详细窗口→插件设置→搜索web-uploader→点击安装，安装好后就能在左侧图床列表看到自定义图床。

点击自定义图床并填写配置：

设置好之后，双击顶部工具栏PicGo图标→选择默认图床→自定义Web图床，然后使用PicGo上传图片就会自动通过PicUploader的接口上传了。

作为uPic的自定义图床

uPic→Preferences→Host→左下角+号→Custom:

如果nginx使用了Nginx添加密码认证，则需要添加Header，点击Other Fields→Add Header Field：

查看日志和历史记录

在PicUploader/logs/文件夹下有上传日志和错误日志。

在Web版中点击左侧栏“逆时针旋转图标”的按钮即可查看上传历史，其中Sm.ms和Imgur由于可匿名上传，所以提供了删除功能。

在Windows上配置

本文档为纯文字文档，如有不懂的，请看详细文档：在Windows上使用PicUploader。

在Windows上搭建Web后台

安装phpstudy，按以下方法配置。

进入D:\phpstudy_pro\Extensions\Nginx1.15.11\conf\vhosts文件夹，在里面新建一个文件名为api.picuploader.com.conf的配置文件，然后把以下配置粘贴进去：

server {
    listen 443 ssl;
    server_name api.picuploader.com;

    client_header_timeout 60s;
    client_body_timeout 60s;
    send_timeout 60s;
    keepalive_timeout  65s;
    client_max_body_size 100m;

    access_log logs/api.picuploader.com.error.log combined;
    error_log logs/api.picuploader.com.error.log error;

    root D:/phpstudy_pro/WWW/PicUploader;

    #https start
    ssl_certificate D:/phpstudy_pro/WWW/PicUploader/accessorys/mkcert/api.picuploader.com.pem;
    ssl_certificate_key D:/phpstudy_pro/WWW/PicUploader/accessorys/mkcert/api.picuploader.com-key.pem;
    ssl_session_timeout 5m;
    ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHellA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
    ssl_prefer_server_ciphers on;
    add_header Strict-Transport-Security "max-age=86400; includeSubdomains; preload";
    #https end

    location / {
        index dashboard.php;
        try_files $uri $uri/ index.php$is_args$args;
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        include fastcgi.conf;
    }
}

ssl_certificate和ssl_certificate_key是https证书和密钥文件，生成这两个文件请查看:使用mkcert配置本地https)。

添加hosts文件指向(点击phpstudy的设置→配置文件→hosst会自动用记事本打开)：

127.0.0.1 api.picuploader.com

启动phpstudy的nginx，如果一切正常，你应该可以在浏览器打开：

api.picuploader.com

添加右键菜单

右击PicUploader/accessorys/add-right-click-menu.bat→以管理员身份运行→按提示填写最后输入y回车安装(注意复制路径如果开头有乱码字符请删掉)。

使用： 右击文件→点击自定义上传菜单→自动弹出黑框→黑框消失表示上传完成→去粘贴。

删除右键菜单： Win+R，输入regedit回车，进入注册表编辑器，找到HKEY_CLASSES_ROOT→*→shell，在这里就能找到你添加的菜单，删掉它，再重新按前面的步骤添加即可。

快捷键上传

下载WinHotKey，打开WinHotKey→New Hotkey...:

记得所有路径都换成你电脑的路径，然后保存，因为我们没有勾选Windows键，所以保存时它会弹出个提示(不用看，点Yes就行)。

使用： 截图→复制到剪贴板→按快捷键→任务栏显示php图标(上传中)→任务栏图标消失(上传完成)→去粘贴。

注意： 如果是Win7，需要升级Windows Management Framework 5.1，请下载安装。

作为Typora上传图片接口

参见：作为Typora图片上传接口。

作为PicGo自定义图床

参见：作为PicGo自定义图床。

作为ShareX的自定义图床

这个有点复杂，文字可能说不太清，直接看详细文档吧：作为ShareX的自定义图床。

查看日志和历史记录

在PicUploader/logs/文件夹下有上传日志和错误日志。

在Web版中点击左侧栏“逆时针旋转图标”的按钮即可查看上传历史，其中Sm.ms和Imgur由于可匿名上传，所以提供了删除功能。

在服务器上搭建

服务器上搭建也是搭建一个php+nginx运行环境，nginx配置文件直接用在Mac上搭建web后台的就行，只不过路径要改改罢了，另外服务器上获取https证书要使用真实证书，申请https证书请查看：https证书自动续订(renew)问题。

注意： 由于PicUploader没有账号系统，在服务器上搭建，需要在nginx添加认证密码，添加方法请查看：Nginx添加密码认证。

点赞

如果觉得PicUploader还不错，给个star鼓励鼓励我吧！

如何支持我

方法一： 如果本工具确实能帮助到你，不妨打赏一下，鼓励一下我继续更新并维护PicUploader。
<img width="200" alt="微信二维码" src="https://www.xiebruce.top/wp-content/uploads/2018/09/wechat.png">

方法二： 如果你能看到我网站中的广告，麻烦帮忙点一下广告。