30

GitHub - xiebruce/PicUploader: 一个还不错的图床工具，支持Mac和Win、支持压缩后上...

 5 years ago
source link: https://github.com/xiebruce/PicUploader
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

README.md

PicUploader

简介

PicUploader-logo.png

PicUploader 是一个用php编写的图床工具，它能帮助你快速上传你的图片到云图床，并自动返回Markdown格式链接到剪贴板。配置完成后，要获取一个可用于markdown的图片外链只需要：
方式一： 右击图片→点击你的自定义上传菜单→通知上传成功→到Markdown编辑器中粘贴！
方式二： 截图并点击复制到剪贴板→按快捷键→通知上传成功→到Markdown编辑器中粘贴！

主要功能

  • 支持Mac和Windows
  • 支持图片压缩后上传(支持jpg/png，gif不支持压缩)
  • 支持添加水印后上传(支持文字水印、图片水印、自定义水印颜色和透明度)
  • 返回的链接可自定义（如原始链接、Markdown格式链接、可点击的Markdown格式链接、完全自定义的链接）
  • 可作为MWeb的API使用（需要自行配置nginx+php服务器）
  • 支持快捷键上传剪贴板中的图片（需要配合PicUploaderHelper使用）
  • 目前支持11个图床：七牛云/腾讯云/网易云/百度云/阿里云/京东云/又拍云/sm.ms/Imgur/Ucloud/QingCloud

这是一个用于演示的gif图，如果你看到这行文字说明它没加载出来，请点我直接跳转链接查看吧，或者使劲强刷

注册存储服务器账号

目前支持七牛云/腾讯云/网易云/百度云/阿里云/京东云/又拍云/sm.ms/Imgur/Ucloud/QingCloud共11种，以下服务选择一种就可以，如果是自己搭建的博客，建议参考我这篇文章：使用nginx负载均衡+多个云的免费额度打造免费markdown图床

注册七牛云

注册腾讯云

注册网易云

注册百度云

注册京东云

注册阿里云

注册又拍云

点击查看又拍云注册使用教程 注意，请不要开启全球cdn，开国内的就可以，国外cdn超贵。

无需注册直接使用sm.ms

  • 直接使用是上传到sm.ms，经过测试，在国内(不含港澳台)使用sm.ms时好时坏，除非开科学上网，否则不稳定，如果小齿轮一直转个不停，基本上就是上传失败超时了。
  • 设置代理：可以上传的情况下不建议设置代理，如果上传超时、报错，则设置代理试试，直接在配置文件填写代理的ip+端口即可，如（127.0.0.1:1087），不过设置代理后上传速度会稍慢（具体快慢取决于你的代理速度）:
//https://sm.ms
'smms' => [
    'baseUrl' => 'https://sm.ms/api/',
    //代理地址，如果使用shadowsocks做代理，ip填http://127.0.0.1（或直接填127.0.0.1）即可，
    //端口从『偏好设置→HTTP→监听端口』找，留空或注释掉表示不使用代理
    'proxy' => 'http://127.0.0.1:1087',
],
  • 注意sm.ms单张图片不能超过5M，但由于我有做压缩，一般不会超过5M，如果上传后粘贴没有内容或者报错，请查看日志，很有可能是这张图片压缩后超过了5M，或者图片是超过5M的gif图（gif图不压缩）

注册Imgur

  • 先注册Imgur：https://imgur.com/register并登录。
  • 然后点击addclient创建Application，这一步能拿到clientID和clientSecret： Xnip2018-11-11_03-56-35.png
  • 虽然注册了Imgur，但用我这个工具上传后，你还是无法从你的Imgur账号上找到你上传的图片，原因是我不是网页应用，所以无法做授权(Imgur不提供其他授权方式，所以上面拿到的clientSecret并没有什么用处)，所以，用Imgur做图床还是相当于匿名图床。
  • 另外，因为Imgur是国外的，如果上传报错，请使用科学上网工具，并在配置文件中打开代理的注释，填写你的代理端口。

注册Ucloud

点击前往注册Ucloud

注册QingCloud

点击前往注册QingCloud

下载使用

下载PicUploader

  • 使用git下载：
git clone https://github.com/xiebruce/PicUploader.git
  • 或者直接下载： PicUploader 注意下载后把它解压放到一个相对稳定一点的目录，不能放在『下载』里面，因为这样你可能随手删除了。（以后最好不要移动，否则要改配置比较麻烦）

填写配置

  • 把PicUploader/config/config.php文件command+D复制一份，命名为config-local.php，然后在config-local.php中修改你的配置(配置你的七牛云/腾讯云/网易云/百度云/阿里云/京东云/又拍云/Imgur/Ucloud/QingCloud其中一个)即可。
  • 如果使用sm.ms，那就不需要修改配置了，直接使用！
  • 以配置七牛云存储为例，在config-local.php文件中找到以下代码，填好AK/SK/bucket/domain四个参数，如果不知道参数怎么来，请查看查看注册七牛云对象存储教程
//Qiniu Cloud
'qiniu' => [
    //七牛云AppKey
    'AK' => 'ASGZ******************************o0AoF',
    //七牛云AppSecret
    'SK' => 'UoC******************************JylkEy',
    //七牛云对象存储空间名
    'bucket' => 'm*****n',
    //七牛云外链域名
    'domain' => 'http://pe5s*********clouddn.com',
    //七牛优化参数，直接加在链接后面，但是不会优化原图，只会优化输出的图片，如果不需要可以不配置该项（即注释掉）
    // 'optimize' => '?imageMogr2/thumbnail/800x/strip/quality/80',
],
  • 搜索storageType(注意是storageType，而不是storageTypes)，并在=>后设置您当前要使用哪个云，如我要使用七牛云：
'storageType' => 'Qiniu',
  • 支持同时上传到多个云，只需逗号隔开即可，比如我现在就同时上传到6个云(多个云会使用最后一个云的域名作为返回域名)：
'storageType' => 'Qiniu,Tencent,Netease,Upyun,Qingcloud,Ucloud',

也许你会觉得奇怪，同时上传到那么多云干嘛？看了这篇文章你就知道了：使用nginx负载均衡+多个云的免费额度打造免费markdown图床

  • 水印配置直接参考配置文件的注释

在macOS上使用

打开『自动操作/Automator』

或者像下面gif图演示的那样用『聚焦搜索』来打开

按下图操作

注意每一个需要选择的地方都不要选错，其中最后一步保存的文件名，将出现在右键菜单上，你可以自己取一个自己喜欢的名字，比如『获取Markdown外链』。 添加一个服务.gif

export LC_CTYPE="zh_CN.UTF-8"
/usr/bin/php /Users/xxxxx/www/PicUploader-master/index.php "$@" | pbcopy

注意：

  • 注意/usr/bin/php这个路径，最好在终端用which php命令来查看它的路径，确认一下是否正确，如果执行which php命令后输出的不是/usr/bin/php，则以which php命令输出的为准。
  • 把/Users/xxxxx/www/PicUploader-master/index.php 的路径换成你自己的index.php路径，怎么看你的index.php路径呢？打开终端，把index.php文件拖到终端上，终端就会显示出它的路径。
  • 特别注意：Mac自带php缺少freetype扩展，导致gd库处理图片的时候报错，如果你是做php开发的，那这个问题你肯定解决了，如果不是，那你需要解决这个问题,先用这下边这个命令看看有没有内容输出，如果什么都没有输出，那就确定是缺少freetype
php -i | grep configure | grep freetype
  • 确定缺少freetype之后，如果你不用水印功能，则可以不理会，如果你要使用水印功能，请使用以下命令重装php(否则会报错)，重装后，上面的/usr/bin/php请直接改成/usr/local/bin/php，不需要看which php的结果了：
brew install php
  • php需要安装gd、curl、exif、fileinfo这四个扩展，前两个必须要有，后两个最好有，查看php有哪些扩展的命令：
/usr/local/bin/php -m

安装扩展请查看：Mac Homebrew1.5以后安装php扩展的方法。

试试右击任意图片

看，最后一个按钮是不是就是你刚刚保存的Services名称？如果你电脑上没看见，是因为你电脑上超过5个这种类似的菜单，它就自动收到二级菜单下了，其实很多菜单根本用不到，你可以到系统偏好设置→键盘→快捷键→服务(Services)里面找到对应的按钮，把它们的勾去掉就行： Xnip2018-09-07_23-58-26.png

如果一切正常，你对着图片右击，并点击右键菜单中的获取Markdown链接后，你将会在Mac顶部工具栏那里看到一个小齿轮在转动，说明图片正在上传，当小齿轮停止转动(不需要等它消失)，即说明上传已经完成，同时右上角会弹出通知，此时剪贴板已经有你上传的图片地址了，直接到markdown编辑器command+v粘贴试试吧。

为你的服务创建快捷键

系统偏好设置→键盘→快捷键→服务(Services)→找到你的自定义菜单添加快捷键即可，添加快捷键后，假设你双手都在键盘上，用空格预览一张图后，决定把它上传，那么只要使用方向键选中它，然后直接按快捷键即可，当然喜欢用鼠标搞定的童鞋也可以不创建。 screenshot_upload_tmp.jpeg

查看上传日志

因为在配置文件中的logPath可以配置日志显示在桌面，'logPath' => 'desktop' ，所以不出意外，你的桌面装会有一个如下图所示的文件夹，这里保存了你上传的图片的Markdown外链地址，你在七牛云（或者其他服务器）是能找到对应的图片的，如果你觉得哪张图片不想要，可以在对应服务器中把它删除了。

这个日志文件也是markdown格式，所以你可以用markdown编辑器查看它，日志是倒序添加的，即最新上传的图片在最前面。

为防止一时忘了粘贴又不小心复制了其他的内容，可以使用 Alfred的历史记录功能找到，当然也可以用Paste剪贴板记录软件找到。

Win10由于权限原因，无法给logs文件夹创建快捷方式到桌面，你必须自己发送到桌面快捷方式。 -w755

在Windows上使用

在Windows上配置环境及右键菜单请查看：PicUploader-Windows-README.md

MWeb配置

mweb提交图片是一张图片发起一个post请求，多张图片则会循环发起多个请求，所以需要配置一个http服务器来接收该post请求并处理上传。 环境要求：nginx + php-fpm 或 apache + php 环境并不是搭建在远程服务器，而是直搭建在你本地电脑即可(当然你把PicUploader当成纯服务使用，搭在远程服务器上也行)，至于怎样搭建nginx+php运行环境或apache+php运行环境，请自行网上搜索。

以下是nginx配置文件（注意修改root路径为你的PicUploader目录实际路径）

server {
    listen 80;
    server_name api.picuploader.com;

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

    root /path/to/PicUploader;

    location / {
        index index.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;
    }
}

此外记得要把nginx配置的域名添加到hosts文件中：

127.0.0.1 api.picuploader.com

点击mweb的偏好设置→发布(publishing)→点击右边最下面一个自定义(custom)：

Xnip2019-01-12_21-29-30.jpg

按下图填写：

Xnip2019-01-12_21-32-44.jpg

写好文章后，点击顶部菜单栏中的的发布(publish)或编辑器右上角的分享按钮→上传本地图片到...(Upload Local Images to...)：

Xnip2019-01-12_21-38-34.jpg

如下图，点击Upload Images：

Xnip2019-01-12_21-48-23.jpg

上传完成后，即会出现地址图片地址，你可以点`New Document`建立一篇新文章，该文章就是你写的这篇文章，只不过图片全部被替换为线上地址了，然后你就可以发布这篇文章了，当然你也可以点`Copy Markdown`或`Copy HTML`复制markdown或html到其他地方(比如你的博客后台)去发布，而且MWeb非常好的一点是，如果你上传过所有图片后，又添加了一张新图片，那么只有新图片会被上传，上传过的不会重复被上传。

使用快捷键上传助手(v2.6.3新增)

Mac版上传助手

在PicUploader的accessorys文件夹中找到PicUploaderHelper-macOS.zip，或者也可以在这里下载：PicUploaderHelper-macOS.zip 上传助手使用文档请查看：PicUploaderHelper-macOS-README.md

Windows版上传助手

在PicUploader的accessorys文件夹中找到PicUploaderHelper-Windows.zip，或者也可以在这里下载：PicUploaderHelper-Windows.zip 上传助手使用文档请查看：PicUploaderHelper-Windows-README.md

注意事项

关于config里的imgWidth选项

  • 由于各个云服务器免费空间有限(七牛云免费10G,好像也不小了哈哈)，而且大文件加载特别慢，所以有些大图片需要压缩后上传，由于试过按质量压缩对图片影响较大，所以选择按宽度压缩（高度会保持等比例适应）。
  • 如果要设置压缩图片，建议imgWidth设置为800或1000，别担心分辨率低的图压缩后看不清，即使设置了该选项，分辨率比较低的图片也是不会被压缩的。
  • 由于gif图片实际上是由很多张图片组合在一起的，它的压缩比较麻烦，需要Mac装一些额外的库，所以暂时选择不压缩gif（也就是说即使你设置了imgWidth为800或者1000，也不会压缩gif图片）
  • 如果你用的是七牛云，则返回的图片地址中『?imageMogr2/thumbnail/800x/strip/quality/80』这部分是七牛云的压缩参数(如果你配置了的话)，也就是说这部分参数你可以去掉直接查看你上传的图，其中thumbnail/800x表示设置宽度为800，strip表示去除一些exif信息以减小图片大小，quality/80表示设置图片质量为原来的80%，其实还可以在最后加个/format/webp这样图片加载会快很多，因为webp能在最大程度还原图片清晰度的同时把图片体积降到最小。

安装管理工具

因为图片上传到七牛云后，在七牛的后台实在无法直观的浏览和管理图片，如果你希望方便管理你的图片，可以下载两款谷歌浏览器插件：

  • qiniu upload files 用来管理七牛云上的图片
  • 七牛云图床 一款可以让你直接上传图片到七牛云的工具，但是它没有分文件夹。
  • 腾讯COS官方MacOS客户端：点击前往下载
  • 百度BOS官方MasOS客户端：点击前往下载
  • 如果是又拍云，因为又拍云没有网页管理工具，只能自己用ftp工具查看。
  • 其他云...自己找吧。

上传完成无法弹出通知问题

  • 一般情况下，上传完成后右上角就会弹出通知，如果你没有弹出，有可能是因为系统没更新的问题，像我的系统版本一直是10.13.1，我的就不弹，但是我让别人试就会弹（后来我更新10.14(Mojave)系统后，就能正常弹出提示了）。
  • 如果你的系统也没更新，那有可能也不会弹通知，那就只能看工具栏上的小齿轮，小齿轮停止转动说明上传完成（不需要等小齿轮消失，停止转动即已完成），然后就可以去markdown编辑器粘贴了。

说个不幸的消息

  • 七牛云默认域名是测试域名，只能使用30天，30天后该域名会被回收，所以你需要绑定自己的域名，但绑定自己的域名需要域名已经备案，而域名备案是跟网站一块的，就是说如果你只买了域名没有自己的网站的话，是无法备案的，这时你可以看看有没有朋友有已备案的域名，叫他给你解析一个二级域名也行，因为一个人一般只用一两个二级域名，所以会有很多二级域名可用的。
  • 又拍云也提供默认测试域名，不过我问过又拍客服，又拍云的测试域名是不会回收的，也就是你可以一直使用，不需要有自己已备案的域名，但缺点是，又拍云的默认域名提供的cdn服务器比较少，也就是说，你用又拍云默认的域名可能加载图片会相对比较慢（相对绑定自己的域名来说），但具体有多慢，我没有试过，所以也是建议你绑定自己的域名，当然了，又拍云绑定自己的域名，同样要求域名已备案，国内所有云都有这个要求！

更新日志

2019-03-27 v2.6.4版本

  • 修改windows的右键安装工具为中文，修改编码为ANSI-GB2312(之前utf-8会导致中文菜单乱码)，添加自定义菜单文字的功能。
  • 修改默认字体文件名为拼音，因为在win10中测试如果字体为中文名会导致找不到字体文件
  • 添加windows上的配置文档，详细讲解如何配置
  • 修改图片处理插件中的抛出异常的bug
  • 添加Windows版PicUploaderHelper及其配置使用文档

2019-03-25 v2.6.3版本

  • 支持全局快捷键上传剪贴板中的图片

2019-01-12 v2.6.2版本

  • 添加mweb支持
  • 添加网页版上传支持

2018-12-06 v2.6.1版本

  • 添加支持Windows系统（理论上Linux系统一样可用，只要你能通过右键菜单或快捷键调用上传命令）

2018-11-24 v2.6版本

  • 添加青云QingCloud及Ucloud的支持
  • 修改结构，去除冗余代码
  • 添加支持同时上传到多个云

2018-11-15 v2.5.2版本

  • 用户指定日志位置后，只创建日志软链接(快捷方式)，日志原文件存储在项目目录下的logs目录中

2018-11-13 v2.5.1版本

  • 修复压缩无效的bug
  • 修复压缩临时文件未删除的问题
  • 添加压缩质量配置

2018-11-11 v2.5版本

  • 添加支持Imgur

2018-10-20 v2.4.1版本

  • 上传图片到sm.ms添加支持使用HTTP代理(如shadowsocks)
  • fix bug

2018-10-20 v2.4版本

  • 添加水印支持（支持文字水印、图片水印）
  • 去掉了上传到sm.ms同时返回了删除链接的问题，但日志里还是会有删除链接

2018-09-21 v2.3版本

  • 修改config结构
  • 使用变量类名动态识别调用不同存储类型对应的类以精简代码
  • 在每个类里动态调用配置文件

2018-09-19 v2.2.2版本

  • 添加又拍云支持

2018-09-08 v2.2.1版本

  • 解决图片文件名为中文时粘贴乱码或者无法粘贴的问题
  • 修改了README.md中说的不清楚的地方，部分英文菜单改用中文

2018-09-06 v2.2版本

  • 添加支持百度云
  • 添加支持京东云
  • 添加支持阿里云

2018-09-06 v2.1版本

  • 添加支持网易云
  • bug fix

2018-09-06 v2.0版本

  • 完全重构代码
  • 添加支持腾讯云
  • 添加上传日志路径配置（可配置到桌面方便随时查看）

2018-09-01 v1.1版本

  • 添加支持https://sm.ms，默认上传到sm.ms
  • 添加mardownWithLink链接类型（点击图片后能跳转到图片链接）
  • fix bug log时间设置成东八区

2018-08-30 v1.0版本

由于个人写markdown需要，目前现有的一些笔记软件都因为各种原因传图并不是很方便，于是写了这个小工具，想到可能有跟我一样需求的童鞋，就顺手发出来供有需要的童鞋使用，如有处理不好的地方在所难免，希望大家能批评指正！

参考资料

七牛云phpsdk文档
百度知道：没有个人网站怎么注册七牛云存储
sm.ms Api
GuzzleHttp官方文档
腾讯云phpsdk文档
网易云phpsdk文档
阿里云phpsdk文档
京东云phpsdk文档
百度云phpsdk文档
又拍云phpsdk文档
Imgur API
google
百度


report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK