安装过程

如果是在windows环境下运行，那么直接下载项目中打包好的文件运行即可。

而在家中nas或者是服务器上运行则需要使用docker来进行安装，下面是写好的docker-compse文件，填好对应内容后，使用docker-compose up -d命令来运行容器。

version: "3"
services:
  iyuu:
    image: difegue/lanraragi:v.0.8.90 #还有一个汉化版本的镜像为windycloud/lanraragi_cn
    container_name: lanraragi
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai
      - http_proxy=http://xxx.com:7890 #这里填代理地址
      - https_proxy=http://xxx.com:7890
    volumes:
      - /volume4/SSD/test/database:/home/koyomi/lanraragi/database #这里左侧填宿主机的数据库地址，推荐设置在SSD中
      - /volume4/SSD/test/content:/home/koyomi/lanraragi/content #这里左侧填宿主机的媒体库地址
      - /volume4/SSD/test/thumb:/home/koyomi/lanraragi/content/thumb #这里左侧填宿主机的缓存地址，推荐设置在SSD中
    ports:
      - 3000:3000 #这里左侧填宿主机端口，不冲突即可
    restart: unless-stopped

不想使用docker-compose命令的也可以直接用命令行来配置

docker run \
   --detach \
   --name lanraragi \
   --env PUID=0 \
   --env PGID=0 \
   --env TZ=Asia/Shanghai \
   --env http_proxy=http://192.168.31.2:7890 \
   --env https_proxy=http://192.168.31.2:7890 \
   --volume /volume4/SSD/test/database:/home/koyomi/lanraragi/database \
   --volume /volume4/SSD/test/content:/home/koyomi/lanraragi/content \
   --volume /volume4/SSD/test/thumb:/home/koyomi/lanraragi/content/thumb \
   --publish 3050:3000 \
   --restart unless-stopped \
   difegue/lanraragi:v.0.8.90

容器启动后，使用默认密码kamimamita即可进入后台设置。

配置插件

lanraragi本身自带了不少元数据插件，其中有些对我们来说没用，有些需要进行配置才可以正常使用，除此之外还有很多第三方插件可以让我们更好的使用lanraragi。

需要安装的插件

• ETagCN

下载地址：https://github.com/zhy201810576/ETagCN/releases/tag/alpha-0.0.1

官方自带的ehentai插件下载下来的tag是英文格式的，这个插件可以在刮削的同时将tag汉化为中文，使用方式可以参见项目文档。

• ETagConverter

下载地址：https://github.com/zhy201810576/ETagConverter/releases/tag/alpha-0.0.1

其他插件刮削下来的英文tag或者是之前已经刮削过，则可以通过这个脚本来一键转换中文

• addEhentaiMetadata

下载地址：https://github.com/chu-shen/LANraragi/blob/feat-ratingAndcomment/lib/LANraragi/Plugin/Scripts/addEhentaiMetadata.pm

虽然lanraragi可以自动为新加入的文件触发刮削，但有时候由于网络波动或者是其他原因导致刮削失败，那么这些没有刮削数据的本子又很难在成堆的本子中检索。这个脚本则可以为所有没有source标签的本子触发一次插件刮削，这样可以进行查缺补漏。

• Tsukihi

下载地址：https://github.com/Difegue/Tsukihi/releases/tag/v.1.2

这个浏览器插件可以在你浏览e站的本子时，在浏览器上显示库中是否已经有了该本子，由于检索的依据是source标签，所以只有库中本子都正确刮削后才能正常使用。需要注意的是，库中的本子source标签是刮削时所使用的数据源，如果一个本子有一个新的画廊，那么此时这个画廊的地址也是一个新的地址，这个插件就没办法识别了。
值得一提的是这个软件可以将本子地址发往lanraragi来快捷下载。

• EhFavoritesDL

下载地址：https://github.com/zyugat/EhFavoritesDL

这个工具可以自动下载e站收藏夹的内容到本地（我自己没用过）

• ComicInfo

下载地址：ComicInfo.pm

使用这个插件可以自动将我整理的压缩包内的元数据导入lanraragi

资源包

下载地址：链接：https://pan.baidu.com/s/1_Vi3CzbKPFunhAPEoiX8cg?pwd=1111

包含上面所说的插件、数据库和docker-compose文件

Lanraragi插件配置

登录插件配置

以上e站相关插件的运行的基础就是需要配置好登录所需要的cookies参数，推荐使用能进入里站的账号。

获取cookies的方法也比较简单，在浏览器打开里站或者表站，点击按F12打开开发者工具，找到网络(network)。找到里面的Cookie处（如图），需要获取ipb_member_id、ipb_pass_hash和igneous还有sk（这个在插件里叫star cookie），对应名称后的值内的内容，就是我们需要获取的内容，分别复制出来填入之前打开备用的插件设置页面内，然后点击网页底端的保存插件配置(Save Plugin Configuration)即可。

下面nhentai的cookies获取方式类似，不过nhentai常年带cf盾，所以需要同时配置好csrftoken、cf_clearance这两个变量。

数据库配置

上述ETagCN和ETagConverter两个插件需要配置数据库文件，最简单的方式就是把文件放到database目录下，然后两者的路径填写/home/koyomi/lanraragi/database/db.text.json即可。

推荐开启自动的插件

需要注意的是，每个插件中Save archive title一定不能开启，否则在刮削成功后会直接将本子的名字改成英文名字。

另外Hentag这个插件需要配置刮削语言才能正常运行，填写chinese,english, japanese即可。

使用技巧

手动指定刮削

有时候因为本子的命名问题会导致插件检索不到，此时可以进入本子的数据管理页面，选择e站的插件后，在旁边的文本框写入本子的地址进行刮削。

刮削成功后记得按一下Save Metadata。

实时压缩图像

有些时候下载下来的本子每张图像可能高达10m，此时如果我们通过网页或者外网阅读时就会很卡，lanraragi提供了在线压缩的功能，可以设定每张图片的传输大小上限和压制的图像质量。

tag规则

项目地址：https://github.com/chu-shen/LANraragi-scripts

lanraragi本身自带有tag的转换规则，因此可以直接利用这点来汉化tag，这样可以使其他插件刮削时实时转换为中文tag。项目中提供了转换规则的脚本，如果懒得使用的话也可以直接使用项目地址中的tags-20230428.txt，复制到图片内的对话框内即可。

阅读客户端

网页

这点就不多说了，可以单页也可以无限滑动。

安卓

Tachiyomi(推荐)

项目地址：https://tachiyomi.org/docs/guides/getting-started

安卓端最强的漫画阅读器，可以添加许多漫画源，其中就有lanraragi的插件，当前由于官方停止更新，并且停止插件源的缘故，目前需要使用第三方的插件源https://github.com/keiyoushi/extensions
安装好后配置好地址和API KEY（在lanraragi后台可设置，默认未开启）后即可使用。

优点：打开速度极快，浏览和检索体验都比较好

缺点：无法使用随机抽取本子的功能，tag搜索后只能按时间排序，并且无法倒序排列。无法上传阅读进度（阅读进度都保存在本地）

Ichaival

项目地址：https://github.com/Utazukin/Ichaival

专门为lanraragi开发的软件

优点：设置书签，可以使用随机抽取功能

缺点：打开软件到加载出图库的时间较长
**2024.7.3更新：**软件在1.8版本新增了自定义同步时间的功能，将其设置为-1即可在打开软件时秒加载内容。虽然不能即使同步服务器的新内容，但加载速度的提升确确实实提升了使用体验。当新增一批本子后，再通过手动同步即可。

IOS

DuReader

项目地址：https://github.com/Doraemoe/DuReader

专门为lanraragi开发的软件

优点：设置书签，可以使用随机抽取功能，可以上传阅读进度

缺点：打开软件到加载出图库的时间略长
现在实际上和网页端速度相仿了，算是目前第三方客户端里体验最好的，推荐优先使用。

Tachimanga(第三方版本)

非国区的商店可以下载，推荐在美区下载。
testflight地址：https://testflight.apple.com/join/FD3X8KuX

优点：加载速度快，使用体验与tachiyomi的其他插件别无二致，并且也可以使用tag快速检索。
缺点：iPhone端不付费的话会有广告，这点可以通过使用tf版解决。ipad端原生无广告。

使用Lanraragi下载本子

在配置好e站登录插件后，点击主界面上方的Add Archives按钮可以进入到这个界面

这里你可以将电脑上的本子上传，也可以在下面填写本子的下载地址，其中e站是可以直接填写本子页面的地址，工具会自动消耗gp来进行下载。
下载的文件会存放在你所设定库的根目录下面。

常见问题

Q:使用插件时提示“Error: Connect timeout at /home/koyomi/lanraragi/script/../lib/LANraragi/Plugin/Metadata/EHentai.pm line 300.”

A:这个是连接不上对应站点的提示，检查网络情况，配置代理。

Q:使用插件时提示"Error: No matching EH Gallery Found!"

A：这个提示代表根据名字在对应站点检索时未检索到对应的本子。有些本子的命名里面的特殊字符可能会导致这一点，可以尝试自己使用书名去尝试检索一下，或者是降低搜索的字符数量来检索，在使用上述的指定网址来进行刮削。