Aipan Netdisk Search is an open-source, self-hostable netdisk (cloud drive) resource aggregation and search platform built on Nuxt 4, combining multi-source search, user submissions, admin review, and Elasticsearch indexing into a single web application.
What is Aipan Netdisk Search?
Aipan Netdisk Search is a full-stack web application that lets you run your own netdisk search engine. It takes netdisk resource links as input, either from built-in sources or user submissions, and produces a searchable index served through a unified API. The platform runs on Nuxt 4 with Vue 3, uses Nitro for server API endpoints, and stores structured data in PostgreSQL with Prisma ORM. The repository is open source and actively maintained, with a live instance at aipan.me.
The front-end search endpoint /api/sources/1 queries both local Resource records and published UserResource documents from Elasticsearch, merging and de-duplicating them to return at most 100 results per request. Administrative features include user-resource review, automatic review queues, Elasticsearch index inspection and rebuild, cloud drive management, a blog, Alist sources, and video online playback.
Key Features
- Unified search endpoint — /api/sources/1 merges local PostgreSQL resources with Elasticsearch-published user resources, de-duplicated and capped at 100 results per call.
- User submission workflow — Resources submitted by users start as pending, and only published status documents are synced to Elasticsearch for front-end search.
- Automatic review system — Server-side queue processes each resource with configurable thresholds via environment variables for auto-approve, auto-reject, link count limits, retries, delays, and dedupe TTL.
- Elasticsearch 8 integration — Connects over HTTPS with Basic Auth and CA fingerprint validation; index can be rebuilt from /admin/search-index/user-resources.
- Admin dashboard — Pages for login, dashboard, cloud drive management, user-resource review, ES index content, and release logs under /admin.
- Notifications and email — Review results create in-app notifications, and when mail service is configured, review emails are throttled per user-email pair (default 24-hour window).
- CI/CD deployment — GitHub Actions workflow builds a Docker image on push to master or manual dispatch, deploys to a server directory at /www/wwwroot/aipan-docker, and runs Lighthouse CI with threshold warnings.
- Tech stack — Nuxt 4, Vue 3, Element Plus, Tailwind CSS, Nitro Server API, PostgreSQL/Prisma, Redis/Socket.IO, Docker, and GitHub Actions.
Who should use Aipan Netdisk Search?
Developers who want to launch a self-hosted netdisk search site will find a complete front and back end ready to deploy. Site operators with a community of contributors can use the review and auto-review pipeline to moderate user-submitted resource links. Teams already running Elasticsearch can integrate a separate ES node and keep the application index synchronized through the admin reindex actions.
What can you do with Aipan Netdisk Search?
- Self-host a netdisk search engine: Deploy your own instance with Docker and configure sources to create a searchable resource catalog like aipan.me.
- Moderate user submissions: Set up automatic review for valid links and manual fallback for ambiguous resources, then notify users of the outcome via in-app and email alerts.
- Scale search with Elasticsearch: Run ES on a separate VPS, connect using the environment variables, and use the admin reindex endpoint to correct index drift.
- Run performance audits in CI: Use the provided npm scripts and Lighthouse CI to check page performance, with reports uploaded as GitHub Actions artifacts.
How does Aipan Netdisk Search work?
When a user submits or edits a resource, it enters pending status. The server enqueues a review job, and the auto-review worker decides whether to publish, reject, or keep the resource pending for manual review. Published resources are upserted into Elasticsearch with a document id based on the resource id. The front-end search endpoint then returns both local and ES results, and admins can rebuild the index from the admin panel if drift is detected.
Pricing
Aipan Netdisk Search is free to use. The repository is open source, and the description on GitHub states that aipan.me is free to use.
FAQ
Does Aipan Netdisk Search require Elasticsearch to run?
No. If Elasticsearch variables are left empty, the /api/sources/1 endpoint degrades to returning only local Resource records. However, production with user-submitted resource search should configure a full ES 8 instance.
How do I start the project locally?
Copy the .env.example file, install dependencies, run Prisma generate and migrate, then start the dev server with npm run dev. The default port is 3001.
What is the maximum number of search results returned?
The /api/sources/1 endpoint returns at most 100 merged and deduplicated results per request.
Is the auto-review feature configurable?
Yes. It is controlled by a set of environment variables prefixed with USER_RESOURCE_AUTO_REVIEW, including flags for enabling auto-review, approving valid resources, rejecting invalid ones, link reachability checks, queue mode, worker concurrency, retries, and dedupe TTL.
