🌐 Bahasa
📖 Deskripsi Proyek
ASMRoner adalah alat baris perintah berbasis Go untuk mencari, mengunduh, menyinkronkan karya audio asmr.one, serta menyediakan antarmuka web pemutar sederhana.
🌐 Proyek turunan: asmr.furina.in — Sebuah halaman mendengarkan ASMR online yang sederhana dan bersih
🚀 Mulai Cepat
https://github.com/MIKANOoOo/asmr-downloader.git && cd asmroner
go build -o asmroner
./asmroner config # 交互式初始化配置📋 Perintah Umum
# 搜索
./asmroner search "护士" -c 20
./asmroner search "护士,-中出@duration:1h" -c 50下载
./asmroner download RJ01037721 -d ./downloads
./asmroner download RJ01037721,RJ02000001 -d ./downloads
./asmroner download hot100 -n 10 -d ./downloads搜索 + 下载/导出
./asmroner search download "护士" -d ./downloads -s 20
./asmroner search export "护士" -n 100 -f data.json同步元数据 & 批量下载
./asmroner sync
./asmroner sync download -d ./downloads
./asmroner sync retry -d ./downloads
./asmroner sync report # 导出单个作品或指定数量热门榜链接 & 导出到指定目录
./asmroner export RJ01544940 -o ./downloads
./asmroner export hot100 -n 20 -o ./downloads
./asmroner export hot100 -n 10 -o ./downloads
更多内容参考常见问题中的guide
Web 播放界面
./asmroner listen -p 8080 ./syncdata📸 Tangkapan Layar
| Pengaturan | Pencarian |
|:---:|:---:|
| 
| 
|
| Unduh | Sinkronisasi |
| 
| 
|
| Sinkronisasi & Unduh | Statistik |
| 
| 
|
| Antarmuka Web | Antarmuka Web 2 |
| 
| 
|
| Antarmuka export | Antarmuka export 2 |
| 
| 
|
✨ Fitur dan Keunggulan
- Pencarian: RJID tunggal/massal, sintaks pencarian lanjutan, ekspor hasil ke CSV/JSON
- Unduh: Unduh karya tunggal/massal/populer, pembatasan otomatis, coba ulang, eksponensial backoff
- Sinkronisasi: Sinkronisasi metadata, kontrol unduhan massal, pelacakan status, coba ulang jika gagal
- Antarmuka Web: Penjelajahan visual, pemutaran dalam browser, desain responsif
- Pengaturan: Inisialisasi interaktif, mendukung proxy, pembatasan, jitter, dan konfigurasi lanjutan lainnya
⚙️ Penjelasan Berkas Konfigurasi
Lokasi berkas konfigurasi: ~/.asmroner/config.toml (format TOML)
[user]
account = "guest"
password = "guest"[downloader]
api_url = "" # 留空自动获取最快站点
proxy_url = "" # 支持 http / socks5
max_workers = 5
max_retries = 3
sync_data_folder = "./syncdata"
sync_wanted_size = "200MB" # 同步容量限制
prefer_media = "all" # all | mp3>wav>flac
[limit]
sync_qps = 2
sync_jitter_min = 100 # ms
sync_jitter_max = 500
download_qps = 0.2
download_jitter_min = 2000
download_jitter_max = 5000
📋 Tinjauan Cepat Opsi Perintah
| Perintah | Opsi | Keterangan |
|------|------|------|
| search | -c | Jumlah hasil pencarian (default 10) |
| search download | -d, -s | Direktori unduh, jumlah unduhan |
| search export | -f, -n | Nama file ekspor (.csv/.json), jumlah ekspor |
| download | -d, -n | Direktori unduh, jumlah hot100 |
| sync download | -d | Direktori unduh |
| sync retry | -d | Direktori file gagal |
| sync export | -s, -f | Status (failed/success), file ekspor |
| listen | -p | Port (default 9999) |
| export | -o, -n | Direktori ekspor, jumlah hot100 |
📁 Struktur Proyek
asmroner/
├── cmd/ # 命令行接口（config/download/search/sync/listen）
├── internal/
│ ├── engine/ # 核心下载引擎（限流、重试、并发控制）
│ ├── logger/ # 结构化日志系统
│ ├── model/ # 数据模型与查询参数解析
│ ├── database/ # SQLite 数据库
│ ├── consts/ # 常量定义
│ └── utils/ # 工具函数
├── webui/ # 内嵌 Web 界面（Tailwind + Plyr）
├── main.go
└── go.mod🛠 Teknologi Stack
| Komponen | Kegunaan | |------|------| | Cobra + Viper | Framework CLI + Manajemen Konfigurasi | | GORM + SQLite | Persistensi Data | | Resty | Klien HTTP (mendukung proxy HTTP/SOCKS5) | | Pond | Pool Pekerja Konkuren | | x/time/rate | Pembatasan Laju Token Bucket | | Gin | Layanan Web | | Tailwind + Plyr | Antarmuka Frontend + Pemutar Audio |
🔧 Masalah Umum
File konfigurasi tidak ditemukan → Jalankan ./asmroner config untuk inisialisasi
Gagal mengunduh (stream error) → Program akan mencoba ulang otomatis; jika masih gagal, gunakan sync retry untuk mencoba ulang, atau cek .asmroner-data/download_errors.log
Antarmuka web tidak dapat diakses → Pastikan port tidak digunakan, coba gunakan -p untuk menentukan port lain
Hasil pencarian kosong → Periksa sintaks query, coba sederhanakan kondisi
Metode unduh untuk perintah export → Lihat guide
🤝 Kontribusi
Silakan ajukan Pull Request! Fork → Buat cabang baru → Komit perubahan → Ajukan PR.
📄 Lisensi
Proyek ini menggunakan lisensi MIT, lihat detailnya pada file LICENSE.
🙏 致谢
- 特别感谢 go-asmr-spider
- 感谢所有贡献者和用户！
ASMRoner — 每天晚上都有不同的妹妹陪你入睡 :)
最后更新：2026 年 2 月
--- Tranlated By Open Ai Tx | Last indexed: 2026-05-05 ---