راه‌اندازی

HolyArrs را از سورس بسازید و روی پورت 6262 در مرورگر باز کنید.

پیش از شروع

Go، با نسخه‌ای که go.mod نام برده است.
Node 24 و npm.
یک ترمینال در ریشهٔ ریپو.

به کامپایلر C نیازی ندارید. بیلدها از CGO_ENABLED=0 استفاده می‌کنند.

بیلد و اجرا

بسته‌های برنامهٔ وب را نصب کنید:
Terminal window
```
npm --prefix app/frontend ci
```
برنامهٔ وب را بسازید:
Terminal window
```
npm --prefix app/frontend run build
```
باید ببینید بیلد تمام می‌شود و app/frontend/dist پر از فایل می‌شود.

برنامه را بسازید:

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

آن را با پوشهٔ پیکربندی خودتان اجرا کنید:
Terminal window
```
./bin/holyarrs -config ./config
```
http://localhost:6262 را باز کنید.

باید ویزارد اولین اجرا را ببینید. حساب مالک را بسازید.

-config یک پوشه روی دیسک محلی می‌گیرد و پیش‌فرضش /config است. -addr نشانی شنیدن را عوض می‌کند و پیش‌فرضش :6262 است.

روی برنامهٔ وب کار کنید

برنامه را در حال اجرا نگه دارید. در ترمینال دوم، سرور توسعه را شروع کنید:

npm --prefix app/frontend run dev

سرور توسعه با هر ذخیره دوباره بارگذاری می‌کند و فراخوانی‌های API را به برنامهٔ در حال اجرا می‌فرستد. باید تغییر خود را ظرف 2 ثانیه در مرورگر ببینید.

گزینه‌ها

از Makefile استفاده کنید

دستور	کارش
`make ui`	بسته‌های وب را نصب می‌کند و برنامهٔ وب را می‌سازد
`make build`	`make ui` و بعد ساختن `bin/holyarrs`
`make test`	`go test` با مهلت 25 دقیقه
`make vet`	`go vet ./...`
`make docker`	ایمیج را با نام `holyarrs:dev` می‌سازد
`make e2e`	آزمایش‌های end-to-end را اجرا می‌کند

یک ویژگی نگه‌داشته‌شده را روشن کنید

بعضی ویژگی‌ها نگه‌داشته شده‌اند و خاموش می‌مانند. نام آن‌ها را در HOLYARRS_FLAGS بنویسید، با کاما جدا:

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

صفحه‌ها ویژگی خاموش را پنهان می‌کنند و مسیرهایش وجود ندارند. کاربران دربارهٔ آن‌ها در ویژگی‌های نگه‌داشته‌شده می‌خوانند.

کتابخانه را با داده‌های نمایشی پر کنید

ابزار demo یک پوشهٔ پیکربندی را با یک مجموعهٔ نمایشی پر می‌کند. فقط روی HolyArrs متوقف‌شده کار می‌کند و فقط روی پوشه‌ای که آن را به‌عنوان lab علامت زده‌اید. یک بار علامت بزنید:

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

بعد seed -config ./config کتابخانهٔ نمایشی را اضافه می‌کند و seed -config ./config -reset-demo فقط همان را که اضافه کرده حذف می‌کند. پوشهٔ رسانه باید /data/media باشد، مگر اینکه -force بدهید. ابزارهای توسعه بیرون از ایمیج می‌مانند. ابزارهای توسعه را ببینید.

اگر کار نکرد

نشانه. بعد از تغییر برنامهٔ وب، صفحه‌ها قدیمی به نظر می‌رسند. علت. برنامه همان بیلدی را ارائه می‌کند که در خودش تعبیه کرده است. راه‌حل. بیلد وب، بعد بیلد Go را اجرا کنید و بعد برنامه را شروع کنید.

نشانه. go build به دلیل نبودن app/frontend/dist خطا می‌دهد. علت. برنامهٔ وب هنوز ساخته نشده است. راه‌حل. اول مرحلهٔ 2 را اجرا کنید.

نشانه. برنامه می‌گوید پورت در حال استفاده است. علت. HolyArrs یا برنامهٔ دیگری 6262 را گرفته است. راه‌حل. نشانی دیگری بدهید: ./bin/holyarrs -config ./config -addr :6263.

برای حرفه‌ای‌ها

کلیدهای ویژگی‌های نگه‌داشته‌شده

کلید	ویژگی
`row_title_stats`	آمار ردیف‌های کشف برای مالک
`trakt_lists`	فهرست‌های Trakt
`alert_channels_more`	کانال‌های اعلان فراتر از Discord و ایمیل
`subtitle_sites`	سایت‌های زیرنویس و جست‌وجوی زیرنویس
`emby_signin`	ورود با Emby
`go_back`	مراحل بازگشت به نسخهٔ قبلی

برای اضافه کردن یکی، نامش را با startup.RegisterFeature ثبت کنید و پیش از ثبت مسیرهایش startup.FeatureOn را بررسی کنید. نام‌ها در app/backend/internal/core/startup (فایل feature.go) هستند.

ابزارهای توسعه

ابزار	دستور	کارش
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` جعلی‌های سایت‌های دارای حساب را اضافه می‌کند
فهرست مسیرها	`go run ./app/backend/tools/apidoc`	مسیرهای API را دوباره می‌نویسد

ایمیج را بسازید

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

ایمیج از FROM scratch شروع می‌شود و برنامه، گواهی‌های CA و مجوزها را دارد. -config /config -addr :6262 را اجرا می‌کند.

صفحه‌های مرتبط

HolyArrs رایگان است. اگر در وقتتان صرفه‌جویی کرد، در GitHub به آن ستاره بدهید، حمایت مالی کنید یا برای من یک قهوه بخرید.