Install - vscodev/neokikoeru GitHub Wiki

手动安装

请前往 Releases 页面下载对应平台的程序包。

以Windows系统为例，下载解压后请双击运行 start.bat ，然后通过浏览器访问 http://localhost:2333 即可。

首次运行系统会自动创建管理员帐号，请留意控制台输出的日志。如果你不小心关闭了控制台，请使用文本编辑器打开 data/log/neokikoeru.log 查看。

如果你的网络无法直连DLsite，你需要编辑 start.bat 文件设置代理，见注释。以Clash为例，代理地址一般为 http://localhost:7890 ，然后 start.bat 文件的内容应该类似下面这样：

@echo off
REM 如果你的网络无法直连DLsite，请取消下面两行注释并编辑环境变量为你的代理地址。
set HTTP_PROXY=http://localhost:7890
set HTTPS_PROXY=http://localhost:7890
set NEOKIKOERU_DLSITE_LOCALE=zh-CN
.\neokikoeru.exe start
pause

使用Docker

创建一个工作目录，例如 neokikoeru 。

mkdir neokikoeru
cd neokikoeru

新建 docker-compose.yml 文件并填入以下内容：

name: neokikoeru

services:
  server:
    image: ghcr.io/vscodev/neokikoeru:latest
    ports:
      - "2333:2333"
    volumes:
      - "./data/:/opt/neokikoeru/data/"
    environment:
      - TZ=Asia/Shanghai
      - PUID=0
      - PGID=0
      - UMASK=022
      - NEOKIKOER_DLSITE_LOCALE=zh-CN
    restart: unless-stopped

启动服务：

docker compose up -d

首次运行系统会自动创建管理员帐号，你可通过查看Docker日志获取。

docker compose logs server

忘记密码可通过 neokikoeru admin 命令重置。

docker compose exec server ./neokikoeru admin

版本更新：

docker compose pull
docker compose up -d

[!TIP] 你可通过设置 NEOKIKOERU_DLSITE_LOCALE 环境变量自定义DLsite API请求使用的语言，以实现作品元数据的本地化。可选值：zh-CN ｜ zh-TW ｜ en-US ｜ ja-JP ，默认值：zh-CN 。

反向代理

在NGINX网站配置文件的 server 块中添加

location / {
    proxy_pass         http://127.0.0.1:2333;
    proxy_http_version 1.1;
    proxy_cache_bypass $http_upgrade;

    # Proxy SSL
    proxy_ssl_server_name on;

    # Proxy headers
    proxy_set_header Host              $host;
    proxy_set_header Upgrade           $http_upgrade;
    proxy_set_header Connection        $connection_upgrade;
    proxy_set_header X-Real-IP         $remote_addr;
    proxy_set_header Forwarded         $proxy_add_forwarded;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-Host  $host;
    proxy_set_header X-Forwarded-Port  $server_port;
    proxy_set_header Range             $http_range;
    proxy_set_header If-Range          $http_if_range;

    # Proxy timeouts
    proxy_connect_timeout              60s;
    proxy_send_timeout                 60s;
    proxy_read_timeout                 60s;
}

你可能还需要在 http 块中添加

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

注意事项

• 不要将个人资料存放在 data 文件夹，因为这是Neokikoeru的应用数据目录。

• 升级新版本可能会出现不兼容的情况，如果遇到错误你需要清除应用数据（删除 data 目录）重新安装。