【图床】npm图床使用

  1. 首先需要注册一个 npm 的账号。访问npm 注册页面

  2. 完成邮箱验证,注册完成后进入账号管理界面:头像->Account,拉倒最上方,你会看到You have not verified your email address字样的提示,点击以后按提示步骤验证你的邮箱。

  3. 找到我们之前创建的图床仓库,在本地合适的位置把它clone下来。找个空文件夹打开终端输入

    1
    2
    3
    git clone git@github.com:[username]/[AssetsRepo].git
    #或者
    git clone https://github.com/[username]/[AssetsRepo].git
  4. 在 clone 下来的[AssetsRepo]文件夹内打开终端,输入以下指令切换回原生源

    1
    npm config set registry https://registry.npmjs.org
  5. 添加本地 npm 用户设置

    1
    2
    3
    4
    # 仅第一次使用需要添加用户,之后会提示你输入你的npm账号密码以及注册邮箱
    npm adduser
    # 非第一次使用直接登录即可,之后会提示你输入你的npm账号密码以及注册邮箱
    npm login
  6. 运行 npm 初始化指令,把整个图床仓库打包,按照指示进行配置,注意需要事先确认你的包名没有和别人已发布的包重复,可以在 npm 官网搜索相应包名,搜不到就说明还没被占用。

    1
    npm init

    最后会输出一段 package.json,请求确认,输入 yes 即可。

  7. 然后输入发布指令,我们就可以把包发布到 npm 上了。

    1
    npm publish
  8. jsdelivr+npm 的图片引用和 jsdelivr+github 很相似,例如我在[AssetsRepo]仓库里存放的/img/index.png

    1
    2
    3
    4
    # jsDelivr+github链接
    https://cdn.jsdelivr.net/gh/[GithubUserName]/[AssetsRepo]/img/index.png
    # jsDelivr+npm链接
    https://cdn.jsdelivr.net/npm/[NpmPackageName]/img/index.png

可以看到 npm 只需要提供包名即可。这也是一开始要求包名不重复的原因之一

jsDelivr+npm 依然有 100MB 的包大小限制,但是 NPM 有丰富的国内节点。可以挑选一个使用。个人推荐知乎的。没有大小限制,而且也很稳定。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
【jsDelivr】
https://cdn.jsdelivr.net/npm/:package@:version/:file
【fastly】
https://fastly.jsdelivr.net/npm/:package@:version/:file
【Tianli0】
https://cdn1.tianli0.top/npm/:package@:version/:file
【unpkg 自建】
https://cdn.cbd.int/:package@:version/:file
【饿了么1】
https://npm.elemecdn.com/:package@:version/:file
【饿了么2】
https://github.elemecdn.com/:package@:version/:file
【知乎】
https://unpkg.zhimg.com/:package@:version/:file

当然你也可以利用unpkg自建。(UNPKG 是一个内容源自 npm 的全球快速 CDN。它部署在 cloudflare 上,在大陆地区访问到的是香港节点。所以速度也不错。)

1
https://unpkg.com/:package@:version/:file
  1. 如果每次都要在本地进行npm publish的话,npm 的提交是整个包一起上传的,不存在增量更新,耗时不说,而且还往往需要架梯子才能正常上传。所以我们可以把它交给 github action 来完成。

    a. 在npm 官网->头像->Access Tokens->Generate New Token,勾选 Automation 选项,Token只会显示这一次,之后如果忘记了就只能重新生成重新配置了。

    b. 在 github 的[AssetsRepo]仓库设置项里添加一个名为NPM_TOKENsecrets,把获取的 Npm 的 Access token 输入进去。

    c. 在 github 的[AssetsRepo]仓库设置项修改Workflow permissions权限


    下滑到底部

    d. 在本地的[AssetsRepo]文件夹下新建[AssetsRepo]/.github/workflows/autopublish.yml,

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    name: Publish to npm

    on:
    # 触发条件1:main 分支收到 push 后执行任务
    push:
    branches:
    - main
    # 触发条件2:手动按钮
    workflow_dispatch:

    jobs:
    publish-npm:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3
    - uses: actions/setup-node@v3
    with:
    node-version: '18.x'
    registry-url: 'https://registry.npmjs.org'

    - name: 更新版本号
    run: |
    git config --global user.email "you@example.com"
    git config --global user.name "Your Name"
    npm version patch --no-git-tag-version
    VERSION=$(node -p "require('./package.json').version")
    git add package.json
    git commit -m "Update version to $VERSION"
    git push

    - run: npm publish
    env:
    NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}

    e. 在本地的[AssetsRepo]文件夹下打开终端,运行以下指令,上传新增内容至 github,即可触发部署。

    1
    2
    3
    4
    5
    # 将更改提交
    git add .
    git commit -m "npm publish"
    # 推送至github触发action
    git push

此处的指令顺序严格。
每次更新 npm 图床都需要先修改[AssetsRepo]\package.json里的version,也就是版本号。
npm version patch即为更新 package.json 里的版本号的指令,效果是末尾版本号+1,例如0.0.1=>0.0.21.1.3=>1.1.4。免去了打开package.json再修改版本号的麻烦。(大版本更新还是需要手动改的)
更新 npm 图床务必要记得更新package.json里的版本号!

由于GitHub action文件中的name: 更新版本号这一步骤已经有了修改版本号的命令,故不再需要在本地修改package.json文件的版本号。只需使用上面三条命令上传到[AssetsRepo]仓库中即可实现自动发布npm包。