அமைவு

HolyArrs-ஐ source-இலிருந்து உருவாக்கி, உங்கள் browser-இல் port 6262-இல் திறக்கவும்.

தொடங்கும் முன்

• Go, go.mod குறிப்பிடும் பதிப்பில்.
• Node 24 மற்றும் npm.
• Repo-வின் மூலத்தில் ஒரு terminal.

உங்களுக்கு C compiler தேவையில்லை. Builds CGO_ENABLED=0 பயன்படுத்துகின்றன.

உருவாக்கி இயக்குதல்

1. Web app packages-ஐ நிறுவவும்:

   npm --prefix app/frontend ci

2. Web app-ஐ உருவாக்கவும்:

   npm --prefix app/frontend run build

   Build முடிந்து app/frontend/dist கோப்புகளால் நிரம்புவது தெரியும்.

3. நிரலை உருவாக்கவும்:

   go build -o bin/holyarrs ./app/backend/cmd/holyarrs

4. உங்கள் சொந்தக் கட்டமைவு அடைவுடன் இயக்கவும்:

   ./bin/holyarrs -config ./config

5. http://localhost:6262 என்பதைத் திறக்கவும்.

   முதல் இயக்க wizard தெரியும். உரிமையாளர் கணக்கை உருவாக்கவும்.

Caution

நிரல் app/frontend/dist-ஐத் தன்னுள் இணைத்துக்கொள்கிறது. Web app மாறிய பிறகு, நிரலுக்கு முன் web app-ஐ மீண்டும் உருவாக்கவும், இல்லையென்றால் பழைய பக்கங்களே வரும்.

-config உள்ளூர் வட்டில் உள்ள ஒரு அடைவை எடுக்கும், இயல்பாக /config. -addr கேட்கும் முகவரியை மாற்றும், இயல்பாக :6262.

Web app-இல் வேலை செய்தல்

நிரலை ஓடவிட்டபடியே வைக்கவும். இரண்டாவது terminal-இல் dev server-ஐத் தொடங்கவும்:

npm --prefix app/frontend run dev

Dev server நீங்கள் சேமிக்கும்போது மீண்டும் ஏற்றும், API அழைப்புகளை ஓடும் நிரலுக்கு அனுப்பும். உங்கள் திருத்தம் 2 s-க்குள் browser-இல் தெரியும்.

தேர்வுகள்

Makefile-ஐப் பயன்படுத்தவும்

கட்டளை	செய்வது
make ui	Web packages-ஐ நிறுவி web app-ஐ உருவாக்கும்
make build	make ui, பிறகு bin/holyarrs-ஐ உருவாக்கும்
make test	25 min timeout உடன் go test
make vet	go vet ./...
make docker	Image-ஐ holyarrs:dev ஆக உருவாக்கும்
make e2e	End-to-end சோதனைகளை இயக்கும்

நிறுத்திவைக்கப்பட்ட வசதியை இயக்கவும்

சில வசதிகள் நிறுத்திவைக்கப்பட்டு அணைந்தே இருக்கும். அவற்றை HOLYARRS_FLAGS-இல் கமாவால் பிரித்துப் பெயரிடவும்:

HOLYARRS_FLAGS=subtitle_sites,ai_apps ./bin/holyarrs -config ./config

அணைந்திருக்கும் வசதியைப் பக்கங்கள் மறைக்கும், அதன் routes இருக்காது. பயனர்கள் அவற்றைப் பற்றி நிறுத்திவைக்கப்பட்ட வசதிகள் பக்கத்தில் படிக்கலாம்.

நூலகத்தை demo தரவால் நிரப்பவும்

Demo கருவி ஒரு கட்டமைவு அடைவை demo தொகுப்பால் நிரப்பும். இது நிறுத்தப்பட்ட HolyArrs-இலும், நீங்கள் lab என்று குறித்த அடைவிலும் மட்டுமே வேலை செய்யும். ஒருமுறை குறிக்கவும்:

go run ./app/backend/tools/demo seed -config ./config -init-lab

பிறகு seed -config ./config demo நூலகத்தைச் சேர்க்கும், seed -config ./config -reset-demo தான் சேர்த்ததை மட்டும் நீக்கும். -force கொடுத்தால் தவிர, ஊடக அடைவு /data/media ஆக இருக்க வேண்டும். Dev கருவிகள் image-இல் சேராது. Dev கருவிகள் பகுதியைப் பார்க்கவும்.

இது வேலை செய்யவில்லை என்றால்

அறிகுறி. Web app-ஐ மாற்றிய பிறகும் பக்கங்கள் பழையதாகத் தெரிகின்றன. காரணம். நிரல் தன்னுள் இணைத்த build-ஐயே வழங்குகிறது. தீர்வு. Web build-ஐ இயக்கவும், பிறகு Go build, பிறகு நிரலைத் தொடங்கவும்.

அறிகுறி. app/frontend/dist இல்லை என்று go build தோல்வியடைகிறது. காரணம். Web app இன்னும் உருவாக்கப்படவில்லை. தீர்வு. முதலில் படி 2-ஐ இயக்கவும்.

அறிகுறி. Port பயன்பாட்டில் உள்ளது என்று நிரல் சொல்கிறது. காரணம். வேறொரு HolyArrs அல்லது பயன்பாடு 6262-ஐப் பிடித்துள்ளது. தீர்வு. வேறு முகவரி கொடுக்கவும்: ./bin/holyarrs -config ./config -addr :6263.

நிபுணர்களுக்கு

நிறுத்திவைக்கப்பட்ட சுவிட்சுகள்

சுவிட்ச்	வசதி
row_title_stats	உரிமையாளருக்கான Explore வரிசைப் புள்ளிவிவரங்கள்
trakt_lists	Trakt பட்டியல்கள்
alert_channels_more	Discord, email தவிர்த்த அறிவிப்பு வழிகள்
subtitle_sites	வசனத் தளங்களும் வசனத் தேடலும்
emby_signin	Emby மூலம் உள்நுழைதல்
go_back	முந்தைய பதிப்புக்குத் திரும்பும் படிகள்

ஒன்றைச் சேர்க்க, அதன் பெயரை startup.RegisterFeature மூலம் பதிவு செய்து, அதன் routes-ஐப் பதிவு செய்யும் முன் startup.FeatureOn-ஐச் சரிபார்க்கவும். பெயர்கள் app/backend/internal/core/startup-இல் (feature.go) உள்ளன.

Dev கருவிகள்

கருவி	கட்டளை	செய்வது
Demo	go run ./app/backend/tools/demo <command> -config DIR	நிறுத்தப்பட்ட கட்டமைவு அடைவில் வேலை செய்யும். கட்டளைகள்: inspect (எண்ணிக்கைகள்), fingerprint, query "SELECT ..." (படிக்க மட்டும்), doctor, seed, showcase
போலி வசனத் தளம்	go run ./app/backend/tools/fakesubs	சோதனைகளுக்காகப் போலி வசனத் தளங்களை 127.0.0.1:18727-இல் வழங்கும். -addr அதை நகர்த்தும்; -accounts-addr கணக்குத் தளப் போலிகளைச் சேர்க்கும்
Route பட்டியல்	go run ./app/backend/tools/apidoc	API routes பக்கத்தை மீண்டும் எழுதும்

Image-ஐ உருவாக்குதல்

docker build --file deploy/Dockerfile --tag holyarrs:dev .
docker run -p 6262:6262 -v ./config:/config holyarrs:dev

Image FROM scratch-இல் தொடங்கி, நிரல், CA சான்றிதழ்கள், உரிமங்கள் ஆகியவற்றைக் கொண்டிருக்கும். இது -config /config -addr :6262 என்று இயங்கும்.

தொடர்புடையவை

• பங்களிப்பு
• சோதனை
• Modules