Files
Auto_Bangumi/docs/faq/troubleshooting.md
Estrella Pan f42a5296e7 docs: translate to English, upgrade VitePress 1.6.4, add API reference
- Upgrade VitePress from 1.0.0-rc.4 to 1.6.4 (stable)
- Update all dependencies (vue 3.5, typescript 5.6, @vue/tsconfig 0.5)
- Remove defunct Documate AI integration and google-analytics plugin
- Add Google Analytics via head config instead
- Translate all 25+ documentation pages from Chinese to English
- Add comprehensive REST API reference (docs/api/index.md)
- Add v3.2 changelog to sidebar navigation (fixes dead link)
- Update version string from v3.1 to v3.2
- Fix homepage changelog link to point to v3.2
- Update all WebUI screenshots with current v3.2 UI
- Add new screenshots: calendar view, bangumi poster wall
- Remove obsolete files: documate.json, deploy/windows.md, deploy/unix.md
- Update CSS variables for VitePress 1.6.x compatibility

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
2026-01-24 09:04:10 +01:00

2.6 KiB

title
title
Troubleshooting

General Troubleshooting Flow

  1. If AB fails to start, check if the startup command is correct. If incorrect and you don't know how to fix it, try redeploying AB.
  2. After deploying AB, check the logs first. If you see output like the following, AB is running normally and connected to QB:
    [2022-07-09 21:55:19,164] INFO:	                _        ____                                    _
    [2022-07-09 21:55:19,165] INFO:	     /\        | |      |  _ \                                  (_)
    [2022-07-09 21:55:19,166] INFO:	    /  \  _   _| |_ ___ | |_) | __ _ _ __   __ _ _   _ _ __ ___  _
    [2022-07-09 21:55:19,167] INFO:	   / /\ \| | | | __/ _ \|  _ < / _` | '_ \ / _` | | | | '_ ` _ \| |
    [2022-07-09 21:55:19,167] INFO:	  / ____ \ |_| | || (_) | |_) | (_| | | | | (_| | |_| | | | | | | |
    [2022-07-09 21:55:19,168] INFO:	 /_/    \_\__,_|\__\___/|____/ \__,_|_| |_|\__, |\__,_|_| |_| |_|_|
    [2022-07-09 21:55:19,169] INFO:	                                            __/ |
    [2022-07-09 21:55:19,169] INFO:	                                           |___/
    [2022-07-09 21:55:19,170] INFO:	Version 3.0.1  Author: EstrellaXD Twitter: https://twitter.com/Estrella_Pan
    [2022-07-09 21:55:19,171] INFO:	GitHub: https://github.com/EstrellaXD/Auto_Bangumi/
    [2022-07-09 21:55:19,172] INFO:	Starting AutoBangumi...
    [2022-07-09 21:55:20,717] INFO:	Add RSS Feed successfully.
    [2022-07-09 21:55:21,761] INFO:	Start collecting RSS info.
    [2022-07-09 21:55:23,431] INFO:	Finished
    [2022-07-09 21:55:23,432] INFO:	Running....
    
    1. If you see this log, AB cannot connect to qBittorrent. Check if qBittorrent is running. If it is, go to the Network Issues section.
      [2022-07-09 22:01:24,534] WARNING:  Cannot connect to qBittorrent, wait 5min and retry
      
    2. If you see this log, AB cannot connect to Mikan RSS. Go to the Network Issues section.
      [2022-07-09 21:55:21,761] INFO:	    Start collecting RSS info.
      [2022-07-09 22:01:24,534] WARNING:  Connected Failed, please check DNS/Connection
      
  3. At this point, QB should have download tasks.
    1. If downloads show path issues, check QB's "Saving Management" → "Default Torrent Management Mode" is set to "Manual".
    2. If all downloads show exclamation marks or no category folders are created in the download path, check QB's permissions.
  4. If none of the above resolves the issue, try redeploying a fresh qBittorrent.
  5. If still unsuccessful, report with logs at Issues.