安装 NekoBox
NekoBox 是基于 Python 的开源项目,安装前需要确保你已经安装了 Python 和相关的依赖。
安装 Python
确保你已经安装了 Python,如果没有安装,可以通过以下命令安装:
python --version
Python 没有安装,可以使用以下命令安装:
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py python get-pip.py
安装 NekoBox
可以通过以下命令安装 NekoBox:
pip install neko-box
初始化数据库
运行 NekoBox 需要一个 SQLite 数据库来存储你的动漫数据,初始化数据库并启动服务器的步骤如下:
初始化数据库
在终端中运行以下命令:
neko-box db init
这将创建一个新的数据库文件,默认名称为 neko.db。
启动服务器
启动 NekoBox 服务器:
neko-box server start
服务器将启动在 http://localhost:9123。
使用 Web 界面
打开浏览器,访问 http://localhost:9123,即可进入 NekoBox 的 Web 界面,以下是一些常用操作:
登录
默认账号和密码是 admin:neko。
导入动漫
- 点击右上角的 按钮,选择
Import from File。 - 选择一个动漫的 XML 文件(如
anidb或MyAnimeList的导出文件)。 - 按下
Import,动漫会被导入到 NekoBox 中。
导入番茄里番里
- 点击右上角的 按钮,选择
Import from AniList或Import from MyAnimeList。 - 输入你的账号信息(需要注册番茄里番里或 MyAnimeList 帐号)。
- 按下
Import,番茄里番里的动漫会被同步到 NekoBox 中。
管理动漫
- 点击动漫卡片,可以查看详细信息、添加标签、调整排序等。
- 使用右侧的工具栏可以进行批量操作,如删除、移动、复制等。
使用 API
NekoBox 提供一个 RESTful API,可以通过 API 来管理动漫数据,你可以使用 POST、GET、PUT 等方法来操作。
获取 API 文档
打开 http://localhost:9123/api/docs,可以查看详细的 API 文档和可用的 API 端点。
示例请求
常用命令
你可以在终端中使用以下命令来管理 NekoBox:
导入动漫
neko-box import <path/to/animation/file>
删除动漫
neko-box delete <anime-name>
批量导入
neko-box import --batch <path/to/animation/files>
启用调试日志
neko-box --debug
高级配置
更改数据库配置
默认数据库存储在 neko.db 文件中,你可以通过以下命令更改数据库名称:
neko-box db create --db-name <new-database-name>
自定义路径
你可以将动漫文件存储在指定的目录中:
neko-box config --storage-path <path/to/storage>
文档与社区
如果你需要更详细的文档或遇到问题,可以参考以下资源:









