feat: add Docker deployment support and update README

Add multi-stage Dockerfile, docker-compose.yml with env passthrough,
and rewrite README with deployment instructions and updated docs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: dragon-fish

.dockerignore

@@ -0,0 +1,12 @@
+.git
+.nuxt
+.output
+dist
+node_modules
+*.log
+.vscode
+.idea
+*.md
+!package.json
+DEV_NOTES
+docker-compose.yml

Dockerfile

@@ -0,0 +1,20 @@
+FROM node:24-alpine AS build
+
+WORKDIR /app
+
+COPY package.json pnpm-lock.yaml .npmrc ./
+RUN corepack enable pnpm \
+    && pnpm install --frozen-lockfile --prefer-offline
+
+COPY . .
+RUN pnpm build
+
+FROM node:24-alpine
+
+WORKDIR /app
+ENV NODE_ENV=production
+
+COPY --from=build /app/.output .output
+
+EXPOSE 3000
+CMD ["node", ".output/server/index.mjs"]

README.md

@@ -1,66 +1,89 @@
 <div align="center">
 
-![PixivNow Logo](src/assets/LogoH.png)
+![PixivNow Logo](app/assets/LogoH.png)
 
-Pixiv Service Proxy
+PixivNow - Now, everyone can enjoy Pixiv!
+
+</div>
+
+## Deploy / 部署
+
+### Docker (推荐)
+
+```bash
+git clone https://github.com/FreeNowOrg/PixivNow.git
+cd PixivNow
+docker compose up -d
+```
+
+服务将在 `http://localhost:3000` 启动。
+
+代码更新后重新构建：
+
+```bash
+git pull && docker compose up -d --build
+```
+
+### Vercel
 
 [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FFreeNowOrg%2FPixivNow&demo-title=PixivNow)
 
-免费部署一个一模一样的服务步骤很简单——点上面的按钮然后一直下一步即可。<br>
-各位爹不要再爬我的服务了好吗？100GB/h的额度都能被您爬完了，我自己还怎么看色图呢？<br>
-好自为之喵，不要怪我骂人喵。
+点击上方按钮一键部署，或 Fork 后在 Vercel 导入项目。
 
-</div>
+如果打算公开你的部署，请小心你的账单。PixivNow 可能会被滥用来大量下载图片，导致流量激增和高额费用。
 
-## API
+### 手动构建
 
-您可以使用以下方式传递用户 token 来鉴权：
+需要 [Node.js](https://nodejs.org/) LTS 和 [pnpm](https://pnpm.io/)。
 
-- Header 以`Authorization`传递
-- Cookie 以键名`PHPSESSID`传递
+```bash
+pnpm install
+pnpm build
+node .output/server/index.mjs
+```
 
-请求路径 `/ajax/*` 的返回结果与 `https://pixiv.net/ajax/*` 的行为完全一致。
+## Environment Variables / 环境变量
 
-以下列举部分 PixivNow 的独特接口：
+| 变量                              | 说明                       | 默认值 |
+| --------------------------------- | -------------------------- | ------ |
+| `NUXT_PUBLIC_PXIMG_BASEURL_I`     | i.pximg.net 图片代理地址   | `/-/`  |
+| `NUXT_PUBLIC_PXIMG_BASEURL_S`     | s.pximg.net 图片代理地址   | `/~/`  |
+| `NUXT_PUBLIC_GOOGLE_ANALYTICS_ID` | Google Analytics ID        | —      |
+| `NUXT_UA_BLACKLIST`               | 屏蔽的 UA 模式 (JSON 数组) | —      |
 
-### `/api/illust/random`
+Docker 部署时可在 `docker-compose.yml` 中添加 `environment` 配置。
 
-返回随机图片，其实是 `/ajax/illust/discovery` 的语法糖，也支持直接返回图片。
+## API
 
-- `max` `{number}` 返回图片的个数
-- `mode` `{'all' | 'safe' | 'r18'}` 其中 `r18` 只有在登录状态且参数设置允许时才会返回
-- `format` `{'image' | 'json'}` 返回的格式，如果 `Accept` 包含 `image` 则预设为 `image`
+通过以下方式传递用户 token 鉴权（二选一）：
 
-### `/api/ranking`
+- Header `Authorization`
+- Cookie `PHPSESSID`
 
-是 `/ranking.php` 的重定向。
+请求路径 `/ajax/*` 的返回结果与 `https://pixiv.net/ajax/*` 行为一致。
 
-### `/user`
+### `/api/illust/random`
 
-通过传入的 token，以 json 格式返回源站 `<meta name="global-data">` 中的用户信息。
+返回随机图片（`/ajax/illust/discovery` 的语法糖）。
 
-## 图片代理
+| 参数     | 类型                       | 说明                                                         |
+| -------- | -------------------------- | ------------------------------------------------------------ |
+| `max`    | `number`                   | 返回图片的个数                                               |
+| `mode`   | `'all' \| 'safe' \| 'r18'` | `r18` 需登录且账号设置允许                                   |
+| `format` | `'image' \| 'json'`        | `Accept` 包含 `image` 时默认为 `image`，image 模式返回重定向 |
 
-本站的图片使用 CloudFlare Workers 进行代理，可以直接访问欣赏众多插画。
+### `/api/ranking`
+
+`/ranking.php` 的重定向。
 
-但是由于遭遇了大量不明流量，因此我们暂时开启了图片代理服务的防盗链。如果您有自行部署整站的需要，可以通过在Vercel环境变量`VITE_PXIMG_BASEURL_I`中传入反代url（首选），或修改 `vercel.json`中的对于图片的重定向配置，图片的请求路径与源站完全一致。
+### `/api/user`
+
+辅助接口，通过传入的 token，返回当前登录用户信息 (globalData->userData)。
 
 ---
 
 _For communication and learning only._
 
-**All data & pictures from query:** &copy;Pixiv & Illusts' authors
-
-> Copyright 2021 PixivNow
->
-> Licensed under the Apache License, Version 2.0 (the "License");<br>
-> you may not use this file except in compliance with the License.<br>
-> You may obtain a copy of the License at
->
-> http://www.apache.org/licenses/LICENSE-2.0
->
-> Unless required by applicable law or agreed to in writing, software<br>
-> distributed under the License is distributed on an "AS IS" BASIS,<br>
-> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
-> See the License for the specific language governing permissions and<br>
-> limitations under the License.
+**All data & pictures from query:** &copy;Pixiv & original authors
+
+> Licensed under the [Apache License 2.0](LICENSE)

docker-compose.yml

@@ -0,0 +1,11 @@
+services:
+  pixivnow:
+    build: .
+    ports:
+      - '${PIXIVNOW_PORT:-3000}:3000'
+    environment:
+      - NUXT_PUBLIC_PXIMG_BASEURL_I=${NUXT_PUBLIC_PXIMG_BASEURL_I:-/-/}
+      - NUXT_PUBLIC_PXIMG_BASEURL_S=${NUXT_PUBLIC_PXIMG_BASEURL_S:-/~/}
+      - NUXT_PUBLIC_GOOGLE_ANALYTICS_ID=${NUXT_PUBLIC_GOOGLE_ANALYTICS_ID:-}
+      - NUXT_UA_BLACKLIST=${NUXT_UA_BLACKLIST:-}
+    restart: unless-stopped

package.json

@@ -14,7 +14,9 @@
     "build": "nuxt build",
     "generate": "nuxt generate",
     "preview": "nuxt preview",
+    "prepare": "nuxt prepare",
     "postinstall": "nuxt prepare",
+    "serve": "node .output/server/index.mjs",
     "changelog": "conventional-changelog -p jquery -i CHANGELOG.md -s -r 0"
   },
   "dependencies": {