วิธีตั้งค่ารหัสผ่านคอนโซลผู้ดูแลระบบสำหรับ Collabora Online

หากคุณสามารถเปิด Collabora Online ได้ แต่ไม่สามารถลงชื่อเข้าใช้ Admin Console ได้ อาจเป็นเพราะข้อมูลรับรองไม่เคยถูกกำหนดค่าไว้สำหรับเซิร์ฟเวอร์ Collabora มาก่อน วิธีแก้ไขขึ้นอยู่กับวิธีการติดตั้ง Collabora: การติดตั้งผ่านแพ็กเกจ Linux จะใช้ยูทิcoolconfigลิตี้ ในขณะที่อิมเมจ Docker อย่างเป็นทางการของ CODE จะยอมรับ ตัวแปรสภาพแวดล้อม usernameและpasswordซึ่งเป็นวิธีการตั้งค่าที่แยกจากกัน เลือกวิธีที่ตรงกับการใช้งานของคุณ

คอนโซลผู้ดูแลระบบเป็นหน้าการจัดการฝั่งเซิร์ฟเวอร์ ไม่ใช่บัญชีเดียวกับผู้ดูแลระบบ Nextcloud ของคุณ การเข้าสู่ระบบของผู้ใช้เอกสาร หรือข้อมูลรับรองการผสานรวม WOPI คู่มือ SDK ของ Collabora เวอร์ชัน 24.04 ระบุที่อยู่คอนโซล วิธีการกำหนดค่า Linux และตัวแปรของอิมเมจ Docker เนื่องจากรายละเอียดการปรับใช้อาจเปลี่ยนแปลงระหว่างเวอร์ชัน โปรดตรวจสอบเอกสารสำหรับเวอร์ชันที่คุณใช้งานก่อนทำการเปลี่ยนแปลงในสภาพแวดล้อมการผลิต: คู่มือ SDK ของ Collabora Online เวอร์ชัน 24.04

เลือกวิธีการกำหนดค่าที่ตรงกับการติดตั้งของคุณ

ขั้นแรกให้ระบุวิธีการติดตั้งใช้งาน หากcoolwsdบริการทำงานโดยตรงในฐานะบริการระบบและโฮสต์มีcoolconfigคำสั่ง ให้ใช้วิธีการแพ็กเกจ หากบริการทำงานในคอนเทนเนอร์ ให้collabora/codeกำหนดค่าสภาพแวดล้อมแทน หลีกเลี่ยงการตั้งรหัสผ่านบนโฮสต์และคาดหวังว่ารหัสผ่านนั้นจะเปลี่ยนแปลงคอนเทนเนอร์ที่กำลังทำงานอยู่

สำหรับการติดตั้งแพ็กเกจ Linux ให้ตั้งรหัสผ่านแบบโต้ตอบ

1. เปิดเทอร์มินัลบนเซิร์ฟเวอร์ Collabora หรือเชื่อมต่อผ่าน SSH โดยใช้บัญชีที่มีสิทธิ์ sudo
2. วิ่งsudo coolconfig set-admin-password.
3. เมื่อระบบถาม ให้ป้อนชื่อผู้ใช้และรหัสผ่านของ Admin Console จากนั้นยืนยันรหัสผ่านอีกครั้ง เทอร์มินัลไม่ควรแสดงรหัสผ่านขณะที่คุณพิมพ์
4. หากการติดตั้งของคุณต้องการรีสตาร์ทบริการหลังจากการเปลี่ยนแปลงการกำหนดค่า ให้เรียกใช้คำสั่งsudo systemctl restart coolwsdตรวจสอบสถานะบริการด้วยคำสั่งsudo systemctl status coolwsd.
5. เปิด URL ของคอนโซลผู้ดูแลระบบ แล้วลงชื่อเข้าใช้ด้วยข้อมูลประจำตัวที่คุณเพิ่งตั้งค่าไว้

โปรแกรมยูทิลิตี้ที่ระบุไว้ในเอกสารนี้ จะขอชื่อผู้ใช้และรหัสผ่านแบบโต้ตอบ และจัดเก็บรหัสผ่านเป็นแฮชที่มีเกลือ (salted hash) ในไฟล์การกำหนดค่า วิธีนี้ดีกว่าการใส่รหัสผ่านธรรมดาลงในบรรทัดคำสั่งโดยตรง หรือการเขียนรหัสผ่านลงในไฟล์ XML ด้วยตนเอง โปรดปฏิบัติต่อคำสั่งนี้ในฐานะการกระทำของผู้ดูแลระบบ: เรียกใช้คำสั่งนี้บนโฮสต์ Collabora ไม่ใช่บนโฮสต์ Nextcloud เว้นแต่ว่า Collabora จะติดตั้งอยู่ที่นั่นด้วย

หากcoolconfigไม่พบ ให้ตรวจสอบว่าเป็นการติดตั้ง Collabora แบบแพ็กเกจ และคุณอยู่บนเซิร์ฟเวอร์ที่ถูกต้องหรือไม่ คอนเทนเนอร์ CODE มีกลไกการกำหนดค่าของตัวเอง หากคำสั่งทำงานสำเร็จ แต่การตรวจสอบสิทธิ์ยังคงล้มเหลว ให้ตรวจสอบชื่อโฮสต์และพอร์ต ลองใหม่อีกครั้งด้วยชื่อผู้ใช้ที่คุณตั้งไว้ และตรวจสอบบันทึกการบริการก่อนที่จะเปลี่ยนการตั้งค่าพร็อกซีหรือ WOPI ที่ไม่เกี่ยวข้อง

สำหรับอิมเมจ Docker ของ CODE ให้ตั้งค่าตัวแปรสภาพแวดล้อมทั้งสองตัว

อิมเมจ CODE อย่างเป็นทางการจะอ่านusernameค่าpasswordจากสภาพแวดล้อมเมื่อคอนเทนเนอร์เริ่มต้นทำงาน เพิ่มค่าทั้งสองลงในการกำหนดค่าคอนเทนเนอร์ การตั้งค่าเฉพาะรหัสผ่านอย่างเดียวไม่เพียงพอ สำหรับ Docker Compose การแมปอาจมีลักษณะดังนี้:

services:
  collabora:
    image: collabora/code
    restart: unless-stopped
    ports:
      - "9980:9980"
    environment:
      username: collabora_admin
      password: ${COLLABORA_ADMIN_PASSWORD}

เก็บรหัสผ่านจริงไว้ในไฟล์สภาพแวดล้อมที่ได้รับการป้องกันหรือที่เก็บข้อมูลลับสำหรับการปรับใช้ แทนที่จะบันทึกไว้ในที่เก็บซอร์สโค้ดหรือวางลงในคำขอความช่วยเหลือสาธารณะ.envไฟล์ Compose สะดวกสำหรับการแทนที่ตัวแปร แต่ก็ยังเป็นไฟล์ที่มีข้อมูลที่ละเอียดอ่อนอยู่ดี ดังนั้นจึงควรจำกัดผู้ที่สามารถอ่านได้ โดยทั่วไปแล้วใครก็ตามที่มีสิทธิ์เข้าถึง Docker daemon สามารถตรวจสอบการกำหนดค่าคอนเทนเนอร์ได้ ดังนั้นตัวแปรสภาพแวดล้อมจึงไม่สามารถทดแทนการควบคุมการเข้าถึงบนโฮสต์ได้

บันทึกไฟล์ Compose แล้วสร้างคอนเทนเนอร์ใหม่เพื่อให้ Docker ส่งค่าสภาพแวดล้อมที่อัปเดตแล้วเมื่อเริ่มต้นระบบ สำหรับบริการที่มีชื่อว่า `<service_name>` collaboraนั้น โดยทั่วไปจะเป็น `<service_name>` docker compose up -d --force-recreate collaboraการรีสตาร์ทคอนเทนเนอร์แบบง่ายๆ จะไม่แทนที่ค่าสภาพแวดล้อมที่จัดเก็บไว้เมื่อสร้างคอนเทนเนอร์นั้น ตรวจสอบเวอร์ชัน Compose และชื่อบริการก่อนเรียกใช้คำสั่ง และหลีกเลี่ยงการแสดงรหัสผ่านแบบตรงตัวในประวัติคำสั่งเชลล์

สำหรับdocker runการใช้งานโดยตรง การตั้งค่าที่เทียบเท่ากันคือตัวแปรสภาพแวดล้อมที่ส่งผ่านด้วย-eเช่น-e username=collabora_adminและ-e password=...ใช้แนวทางการจัดการความลับของคุณในการกำหนดค่า อย่าคัดลอกรหัสผ่านตัวอย่างจากบทช่วยสอนไปใช้กับบริการที่เข้าถึงได้จากอินเทอร์เน็ต

เปิดคอนโซลผู้ดูแลระบบและยืนยันการเข้าสู่ระบบ

เส้นทางคอนโซลที่ระบุไว้คือ/browser/dist/admin/admin.html. บนพอร์ตเริ่มต้น URL แบบเต็มคือhttps://your-collabora-host:9980/browser/dist/admin/admin.html. หาก TLS สิ้นสุดที่พร็อกซีแบบย้อนกลับ ให้ใช้ชื่อโฮสต์ HTTPS สาธารณะและพอร์ตที่พร็อกซีนั้นเปิดเผย ที่อยู่อาจแตกต่างกันหากผู้ดูแลระบบของคุณกำหนดค่าพอร์ตหรือการกำหนดเส้นทาง URL ที่ไม่ใช่ค่าเริ่มต้น

ลงชื่อเข้าใช้และยืนยันว่าคอนโซลโหลดข้อมูลการตรวจสอบแล้ว คู่มือ SDK อธิบายการตรวจสอบเซสชันแบบเรียลไทม์ รวมถึงเอกสารที่เปิดอยู่และผู้ใช้ เนื่องจากคอนโซลสามารถเปิดเผยรายละเอียดการทำงานและอนุญาตให้ดำเนินการด้านการดูแลระบบ เช่น การปิดเซสชันเอกสาร จึงควรจำกัดการเข้าถึงเฉพาะผู้ดูแลระบบที่เชื่อถือได้ ใช้ HTTPS และหลีกเลี่ยงการเปิดเผยจุดเชื่อมต่อการจัดการสู่สาธารณะทางอินเทอร์เน็ตอย่างกว้างขวาง ใช้ข้อจำกัดเครือข่ายที่ไฟร์วอลล์หรือพร็อกซีแบบย้อนกลับหากการใช้งานของคุณรองรับ

สำหรับการติดตั้งแพ็กเกจ ให้ตรวจสอบว่าบริการทำงานได้อย่างปกติด้วยคำสั่ง `npm install` sudo systemctl status coolwsdสำหรับ Docker ให้ตรวจสอบสถานะของคอนเทนเนอร์ด้วยคำสั่ง `npm run container` docker compose psและตรวจสอบบันทึกการทำงานล่าสุดด้วยdocker compose logs --tail=100 collaboraคำสั่ง `npm run container` บริการที่ทำงานได้ปกติเพียงอย่างเดียวไม่ได้พิสูจน์ว่ารหัสผ่านถูกต้อง การตรวจสอบขั้นสุดท้ายคือการเข้าสู่ระบบสำเร็จที่ URL ของ Admin Console

ความเข้าใจผิดที่พบบ่อยและสิ่งที่ควรทำแทน

“คอนโซลผู้ดูแลระบบใช้รหัสผ่าน Nextcloud ของฉัน”

โดยค่าเริ่มต้นจะไม่ใช่ ข้อมูลรับรองของ Collabora Admin Console จะถูกกำหนดค่าบนเซิร์ฟเวอร์ Collabora แยกต่างหากจากบัญชีผู้ใช้ Nextcloud การดำเนินการ: ใช้coolconfig set-admin-passwordกับการติดตั้งแพ็กเกจ หรืออัปเดตสภาพแวดล้อมคอนเทนเนอร์ CODE และสร้างคอนเทนเนอร์ใหม่

“ฉันได้แก้ไขไฟล์ Docker Compose แล้ว ดังนั้นคอนเทนเนอร์ที่กำลังทำงานอยู่จึงมีรหัสผ่านใหม่”

การแก้ไขไฟล์นี้จะไม่เปลี่ยนแปลงสภาพแวดล้อมที่บันทึกไว้ของคอนเทนเนอร์ที่มีอยู่แล้ว ขั้นตอนการดำเนินการ: สร้างบริการ Compose ที่เกี่ยวข้องขึ้นใหม่ จากนั้นทดสอบข้อมูลรับรองใหม่ อย่าแสดงรหัสผ่านในเอาต์พุตคำสั่งและการควบคุมเวอร์ชัน

“หาก URL ของคอนโซลผู้ดูแลระบบเปิดขึ้น แสดงว่าเซิร์ฟเวอร์ได้รับการรักษาความปลอดภัยแล้ว”

การเข้าถึงหน้าเว็บพิสูจน์ได้เพียงว่าเส้นทางตอบสนองเท่านั้น ไม่ได้พิสูจน์ว่ามีการกำหนดค่าข้อมูลประจำตัวที่ปลอดภัยหรือว่าการเข้าถึงเครือข่ายถูกจำกัด คู่มือ SDK ระบุว่าคอนโซลจะถูกปิดใช้งานเมื่อไม่ได้ตั้งค่าชื่อผู้ใช้หรือรหัสผ่านที่จำเป็น และอธิบายถึงฟังก์ชันการตรวจสอบการดูแลระบบ การดำเนินการ: ตั้งรหัสผ่านที่ไม่ซ้ำกัน ยืนยันว่าจำเป็นต้องมีการตรวจสอบสิทธิ์ และจำกัดผู้ที่สามารถเข้าถึงปลายทางคอนโซลได้

“คอนโซลผู้ดูแลระบบคือสถานที่สำหรับตั้งค่าข้อมูลรับรองการแก้ไขเอกสาร”

รหัสผ่านคอนโซลใช้สำหรับป้องกันอินเทอร์เฟซการจัดการ ไม่ได้ใช้แทนการกำหนดค่าโฮสต์ WOPI หรือระบบยืนยันตัวตนที่ใช้โดยแพลตฟอร์มไฟล์ของคุณ การดำเนินการ: ปล่อยการตั้งค่า WOPI และพร็อกซีแบบย้อนกลับไว้ตามเดิม เว้นแต่คุณกำลังแก้ไขปัญหาการเชื่อมต่อเหล่านั้นแยกต่างหาก

หากการเข้าสู่ระบบยังคงล้มเหลว

• ตรวจสอบว่า Collabora ทำงานเป็นบริการโฮสต์หรือในคอนเทนเนอร์ CODE จากนั้นให้ใช้เฉพาะเส้นทางการกำหนดค่าที่ตรงกันเท่านั้น
• ตรวจสอบ URL ของคอนโซลสาธารณะให้ถูกต้อง รวมถึง HTTPS, พอร์ต และ/browser/dist/admin/admin.htmlอื่นๆ
• สำหรับ Docker ให้ตรวจสอบว่าทั้งสองอย่างusernameมีpasswordอยู่ในไฟล์การกำหนดค่าบริการที่ใช้งานอยู่ และสร้างคอนเทนเนอร์ใหม่หลังจากทำการเปลี่ยนแปลงแล้ว
• สำหรับการติดตั้งแพ็กเกจ ให้เรียกใช้coolconfigคำสั่งแบบโต้ตอบอีกครั้งบนโฮสต์ Collabora และตรวจสอบcoolwsdสถานะและบันทึกต่างๆ
• หากมีการใช้งาน Reverse Proxy โปรดขอให้ผู้ดูแลระบบตรวจสอบว่าเส้นทาง Admin Console และการรับส่งข้อมูล WebSocket ที่จำเป็นนั้นส่งผ่านอย่างถูกต้อง อย่าลดทอนการตรวจสอบสิทธิ์เพื่อแก้ไขปัญหาที่เกิดจากพร็อกซี

เมื่อคุณสามารถเข้าสู่ระบบได้และบริการทำงานได้อย่างปกติแล้ว ให้บันทึกข้อมูลประจำตัวใหม่ลงในโปรแกรมจัดการรหัสผ่านที่คุณอนุมัติ และระบุว่าโฮสต์หรือคอนเทนเนอร์ใดเป็นเจ้าของข้อมูลประจำตัวนั้น การกำหนดค่าคอนโซลผู้ดูแลระบบของ Collabora อาจแตกต่างกันไปตามเวอร์ชันและวิธีการบรรจุ คู่มือ SDK เวอร์ชัน 24.04 ที่อ้างถึงข้างต้นเป็นเวอร์ชันเฉพาะ ดังนั้นโปรดใช้เอกสารที่ตรงกันสำหรับเวอร์ชันที่ใหม่กว่าหรือการปรับใช้เพื่อปรับแต่งโดยผู้จำหน่าย