1. 前往Releases，下载randomPicv2ForWindows.zip

2. 解压压缩包，找到双击启动.cmd，运行它。

3. 如果命令行黑框中给出了 api 的 url 链接（一般是http://localhost:3000/info），就说明 api 已经启动成功。

4. 为了使 api 能够输出图片，还需要向刚刚程序生成的Pics文件夹中放入一些图片。

5. 浏览器访问 http://localhost:3000/random-picture?302，就会从 Pics 文件夹中挑选一张随机的图片，并显示出来。

以上是默认情况，如果有修改 config.js，情况可能会有所不同，比如程序试图使用的端口已经被占用、修改了程序使用的图片源。

由于改的东西有一点多，代码几乎都是新写的，所以新开了一个仓库。旧仓库在randomPic。

• 直接访问网站不再直接提供图片，需要使用下面列出的 API。
• V2 对 API 进行了大量修改，因此不能兼容使用 V1 API 的程序。
• 对比 V1，V2 的 API 更加规整了，以及多了些有的没的的细节更改

• 一个常量就是一个配置项

• 使用.js 作为配置项，就可以直接把配置 import 到程序里，不用读取文件什么的了

• 缺点是没法动态读取配置，配置修改后要重启服务

• 配置项说明

  配置项	默认值	说明
  port	3000	程序使用的端口。如果和其他程序有冲突，就得改成其他的（建议在 1000-65535 之间）
  allowedPicExt	[".jpg", ".jpeg", ".png"]	只检测拥有这个列表里的格式的文件。也可以添加其他非图片的格式，不过这还需要稍微修改一下代码，以便于程序能够正确输出它的 MimeType
  docUrl	https://github.com/yige233/randomPic#readme	API 的文档链接
  enableMd5	false	是否在输出图片时为图片添加 md5 信息，即添加Content-MD5头
  collections	{ collectionName : [ source1, source2, ...] }	核心配置。此处配置 api 将用到的图片的源。下面称其为 图册 。 图册下面有多个收藏夹，每个收藏夹都是图册的一个属性。属性名可随意，但不能使用这些特殊字符：/ | \ : ? @ # = ;。该属性名也作为该收藏夹的名称。 收藏夹的值是一个数组，数组内是若干个驱动对象。 驱动对象的用处，是用来将不同类型的图片源整合成 api 可统一访问的形式。

• 驱动对象的结构：{ type, data }

• 驱动对象说明

  type 可选的值	说明	对应的 data 的结构	说明
  localFolder	表示类型为本地文件夹（会遍历子文件夹）	[folderPath, ...]	数组，元素是文件夹路径。Windows 下路径中的反斜杠应改成正斜杠: \ => /
  localPic	表示类型为本地文件	[picPath, ...]	数组，元素是文件路径。Windows 下路径中的反斜杠应改成正斜杠: \ => /
  AlistV3Folder	表示类型为 Alist V3 文件夹（不会遍历子文件夹）	{ host: string, paths: array, ?passwd: string }	数组，元素是一个对象，分别有host(alist 地址)、paths(数组，元素是 alist 文件夹挂载路径)和passwd(访问密码)三个属性
  AlistV3Pic	表示类型为 Alist V3 文件	{ host: string, paths: array, ?passwd: string }	数组，元素是一个对象，分别有host(alist 地址)、paths(数组，元素是 alist 文件路径)和passwd(访问密码)三个属性

{
  "code": number,
  "status": string,
  "message": string,
  "data": object || null
}

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "code": 200,
  "status": "OK",
  "message": "OK",
  "data": {
    "version": "2.0.0",
    "doc": "https://github.com/yige233/randomPic#readme",
    "collections": [ "Default" ]
  }
}

如果需要反向代理，有一个应该注意的点：如果反向代理的 URI 路径结尾要和被代理的后端地址保持一致，即要么都以/结尾，要么都不以/结尾

ProxyPass "/randomPic/"  "http://localhost:3000/"
ProxyPassReverse "/randomPic/"  "http://localhost:3000/"

ProxyPass "/randomPic"  "http://localhost:3000"
ProxyPassReverse "/randomPic"  "http://localhost:3000"

ProxyPass "/randomPic"  "http://localhost:3000/"
ProxyPassReverse "/randomPic"  "http://localhost:3000/"