การตั้งค่าเริ่มต้น

ตั้งค่า

สร้าง HolyArrs จากซอร์สโค้ด แล้วเปิดในเบราว์เซอร์ที่ port 6262

ก่อนเริ่ม

Go เวอร์ชันที่ระบุใน go.mod
Node 24 และ npm
เทอร์มินัลที่เปิดอยู่ที่รากของ repo

ไม่ต้องใช้ C compiler บิลด์ใช้ 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

แก้เว็บแอป

เปิดโปรแกรมทิ้งไว้ แล้วเริ่ม dev server ในเทอร์มินัลที่สอง:

npm --prefix app/frontend run dev

Dev server จะโหลดใหม่เมื่อบันทึก และส่งการเรียก API ไปยังโปรแกรมที่กำลังรันอยู่ ต้องเห็นสิ่งที่แก้ในเบราว์เซอร์ภายใน 2 วินาที

ตัวเลือก

ใช้ Makefile

คำสั่ง	ทำอะไร
`make ui`	ติดตั้งแพ็กเกจของเว็บและสร้างเว็บแอป
`make build`	รัน `make ui` แล้วสร้าง `bin/holyarrs`
`make test`	`go test` พร้อม timeout 25 นาที
`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

หน้าเว็บจะซ่อนฟีเจอร์ที่ปิดอยู่ และเส้นทางของมันจะไม่มี ผู้ใช้อ่านเรื่องนี้ได้ในฟีเจอร์ที่ยังไม่เปิดให้ใช้

เติมคลังด้วยข้อมูลตัวอย่าง

เครื่องมือ demo จะเติมโฟลเดอร์คอนฟิกด้วยคอลเลกชันตัวอย่าง ใช้ได้เฉพาะกับ HolyArrs ที่หยุดอยู่ และเฉพาะโฟลเดอร์ที่คุณทำเครื่องหมายว่าเป็นแล็บ ทำเครื่องหมายครั้งเดียว:

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

จากนั้น seed -config ./config จะเพิ่มคลังตัวอย่าง และ seed -config ./config -reset-demo จะลบเฉพาะสิ่งที่เพิ่มไว้ โฟลเดอร์สื่อต้องเป็น /data/media เว้นแต่จะใส่ -force เครื่องมือสำหรับนักพัฒนาไม่ถูกรวมใน image ดูเครื่องมือสำหรับนักพัฒนา

ถ้าไม่ทำงาน

อาการ. หน้าเว็บยังดูเป็นของเก่าหลังแก้เว็บแอป สาเหตุ. โปรแกรมให้บริการบิลด์ที่ฝังไว้ในตัว วิธีแก้. รันบิลด์เว็บ แล้วบิลด์ Go แล้วจึงเริ่มโปรแกรม

อาการ. go build ล้มเหลวเพราะไม่มี app/frontend/dist สาเหตุ. ยังไม่ได้สร้างเว็บแอป วิธีแก้. รันขั้นที่ 2 ก่อน

อาการ. โปรแกรมบอกว่า port ถูกใช้อยู่ สาเหตุ. มี HolyArrs ตัวอื่นหรือแอปอื่นใช้ 6262 อยู่ วิธีแก้. ระบุที่อยู่อื่น: ./bin/holyarrs -config ./config -addr :6263

สำหรับผู้เชี่ยวชาญ

สวิตช์ของฟีเจอร์ที่ยังไม่เปิดให้ใช้

สวิตช์	ฟีเจอร์
`row_title_stats`	สถิติของแถวใน Explore สำหรับเจ้าของ
`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ใหม่

สร้าง 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

หน้าที่เกี่ยวข้อง

HolyArrs ใช้ได้ฟรี ถ้าช่วยประหยัดเวลาคุณได้ กดดาวบน GitHub, สนับสนุนโปรเจกต์ หรือ เลี้ยงกาแฟผู้พัฒนา