หน้านี้มีรายละเอียดของโปรเจ็กต์การเขียนเชิงเทคนิคที่ได้รับการยอมรับสำหรับ Google Season of Docs
สรุปโปรเจ็กต์
- องค์กรโอเพนซอร์ส:
- Whonix
- นักเขียนเชิงเทคนิค:
- 0brand
- ชื่อโปรเจ็กต์:
- Document Installation and Setup of the New Security-focused Hardened Debian Linux Distribution.
- ระยะเวลาของโปรเจ็กต์:
- ระยะเวลามาตรฐาน (3 เดือน)
คำอธิบายโปรเจ็กต์
Hardened Debian เป็น Linux Distribution ใหม่ที่เน้นด้านความปลอดภัย ซึ่งนักพัฒนาซอฟต์แวร์ Whonix กำลังพัฒนาอย่างต่อเนื่อง โปรเจ็กต์นี้จะบันทึกการติดตั้งและการตั้งค่า Hardened Debian ใน Windows/VirtualBox ตั้งแต่เริ่มต้น โดยเน้นการให้ความรู้แก่ผู้ใช้ Linux ครั้งแรกด้วยทักษะที่จำเป็นเพื่อให้ผู้ใช้สามารถใช้งาน Linux Distribution ได้ด้วยตนเอง
เป้าหมายของโปรเจ็กต์
สร้างเอกสารหลัก
ระยะเริ่มต้นของโปรเจ็กต์นี้จะเน้นที่เอกสารหลักสำหรับ Hardened Debian ซึ่งประกอบด้วยภาพรวมโปรเจ็กต์ที่ครอบคลุม บทแนะนำสำหรับการติดตั้งและการตั้งค่า Hardened Debian รวมถึงคำแนะนำและเคล็ดลับหลังการติดตั้ง
สร้างพื้นที่การเรียนรู้สำหรับผู้ใช้ Linux ใหม่
การสอนผู้ใช้ Linux ใหม่ไม่ได้หมายถึงการเขียนหน้าคู่มือ 2-3 หน้าแล้วบอกว่าเป็นพื้นที่การเรียนรู้ ผู้เริ่มต้นหลายคนไม่คุ้นเคยกับการโต้ตอบกับพรอมต์คำสั่งและการแก้ปัญหาด้วยตนเอง หน้าเหล่านี้จะเน้นที่ทักษะ CLI การแก้ปัญหาในทางปฏิบัติ และแนวทางปฏิบัติแนะนำในการแก้ปัญหา
แยกเอกสาร Hardened Debian ออกจากเอกสาร Whonix (Anonymity OS) อย่างชัดเจน
แม้ว่า Whonix.org จะเป็นที่เก็บทั้ง Whonix และ Hardened Debian แต่ระบบปฏิบัติการแต่ละระบบมีกรณีการใช้งานที่แตกต่างกันมาก ซึ่งอาจนำไปสู่ผลลัพธ์ที่ร้ายแรงหากผู้ใช้สับสนระหว่างระบบปฏิบัติการทั้ง 2 ระบบ ตัวอย่างเช่น Whonix เป็นที่รู้จักกันดีในด้านการไม่เปิดเผยตัวตน แต่ผู้ใช้ใหม่ที่ไม่คุ้นเคยกับ Whonix อาจตั้งค่า Hardened Debian และคิดว่าตนเองกำลังท่องเว็บโดยไม่เปิดเผยตัวตน เพื่อป้องกันข้อผิดพลาดประเภทนี้ เอกสาร Hardened Debian จะจำกัดไว้ในพื้นที่แยกต่างหากของ Whonix.org โดยใช้รูปแบบการจัดรูปแบบใหม่คล้ายหนังสือ ซึ่งแตกต่างจากรูปแบบการจัดรูปแบบเอกสาร Whonix OS นอกจากนี้ เราจะใส่คำเตือนไว้ในพื้นที่สำคัญๆ เช่น หน้าดาวน์โหลด Hardened Debian เพื่อป้องกันไม่ให้ผู้ใช้ทำผิดพลาดเหล่านี้
เอกสารที่ใช้งานง่าย
การติดตั้งและการตั้งค่า Linux Distribution อาจเป็นเรื่องที่ท้าทายแม้สำหรับผู้ใช้ที่มีประสบการณ์ แม้ว่า UI ที่ใช้งานง่ายและใช้งานได้โดยสัญชาตญาณจะช่วยเพิ่มประสบการณ์ของผู้ใช้ แต่การเขียนเอกสารที่ชัดเจนและทำตามได้ง่าย ซึ่งก็คือเอกสารที่ใช้งานง่าย ก็มีความสำคัญไม่แพ้กัน เนื่องจากฐานผู้ใช้ Hardened Debian มีตั้งแต่ผู้เริ่มต้นไปจนถึงผู้ใช้ Linux ขั้นสูง เราจึงต้องระมัดระวังไม่ให้เขียนเอกสารโดยอิงตามความเชี่ยวชาญและความเข้าใจด้านเทคนิคของนักเขียนเชิงเทคนิคเพียงอย่างเดียว แต่เราจะบันทึก Hardened Debian จากมุมมองของผู้เริ่มต้นใช้ Linux ที่อาจพบว่าการทำงานที่ผู้ใช้ที่มีประสบการณ์มองว่าเรียบง่ายและทำได้ง่ายนั้นเป็นเรื่องยาก
กระตุ้นการมีส่วนร่วม/การสนับสนุนจากชุมชน
Hardened Debian เป็นโปรเจ็กต์ที่ท้าทาย ซึ่งจะทำได้สำเร็จทั้งหมดก็ต่อเมื่อชุมชนมีส่วนร่วมอย่างต่อเนื่องตลอดระยะเวลาของโปรเจ็กต์ สมาชิกชุมชนจะมีส่วนร่วมอย่างต่อเนื่องก็ต่อเมื่อความคิดเห็นของสมาชิกได้รับการตอบรับอย่างกระตือรือร้นและมีการนำไอเดียดีๆ ของสมาชิกไปใช้เพื่อปรับปรุงเอกสาร ตลอดระยะเวลา GSoD ฉันจะยังคงมีส่วนร่วมในฟอรัม Whonix เพื่อกระตุ้นให้ชุมชนแสดงความคิดเห็นและสนับสนุนการปรับปรุงเอกสาร
เปลี่ยนชื่อ Hardened Debain OS
แม้ว่าระบบปฏิบัติการนี้จะอิงตาม Hardened Debian แต่เราต้องหาชื่อใหม่เพื่อหลีกเลี่ยงการละเมิดเครื่องหมายการค้า เพื่อให้บรรลุเป้าหมายนี้ เราจะกระตุ้นให้ชุมชน Whonix ส่งชื่อที่ติดหูมาให้นักพัฒนาซอฟต์แวร์ Whonix เลือก แม้ว่าตอนนี้จะยังอยู่ในโหมดระดมสมอง แต่ 2 ตัวเลือกแรกของฉันคือ "Sentient Linux" และ "Sentinel Linux"
ไทม์ไลน์ของโปรเจ็กต์
เราจะแบ่งไทม์ไลน์ของโปรเจ็กต์นี้ออกเป็น 7 เป้าหมายย่อยๆ ซึ่งจะใช้เพื่อวัดความคืบหน้าและทำการปรับเปลี่ยนเพื่อให้แต่ละส่วนเสร็จสมบูรณ์ตามเวลา หากพบปัญหาในระหว่าง Season of Docs ฉันจะแจ้งให้เมนเทอร์ทราบทันทีเพื่อวางแผนการดำเนินการแก้ปัญหา
2 ก.ย. (เริ่มโปรเจ็กต์ Season of Docs)
หน้าแรกจะแสดงภาพรวมของ Hardened Debian โดยให้รายละเอียดเกี่ยวกับประเด็นสำคัญของระบบปฏิบัติการ
เอกสารเริ่มต้นจะประกอบด้วยการติดตั้ง Hardened Debian ใน Windows/VirtualBox ซึ่งจะจำกัดขอบเขตเริ่มต้นของบทนี้ อย่างไรก็ตาม เราจะกระตุ้นให้สมาชิกชุมชนทดสอบ Hardened Debian ในโฮสต์ Linux รวมถึงไฮเปอร์ไวเซอร์ KVM และบันทึกสิ่งที่พบ
ตารางแสดงรายละเอียดระบบปฏิบัติการโฮสต์ที่รองรับ
ตารางแสดงรายละเอียดข้อกำหนดของฮาร์ดแวร์
- ข้อกำหนดขั้นต่ำ
- แนะนำ
- เพื่อประสิทธิภาพที่ดีที่สุด
เนื้อหาจะประกอบด้วยภาพรวมที่แสดงรายละเอียดเป้าหมายการพัฒนาและการใช้งาน Hardened Debian ตามด้วยตารางที่แสดงรายละเอียดคอมโพเนนต์แต่ละรายการ
เป้าหมายของ Hardened Debian
- Linux Distribution ที่เน้นด้านความปลอดภัย
- ฟรีและโอเพนซอร์ส
- ผู้ใช้กำหนดค่าได้
- มีการเสริมความปลอดภัยโดยค่าเริ่มต้น
ตารางแสดงคอมโพเนนต์ที่ประกอบขึ้นเป็น Hardened Debian
- ไฮเปอร์ไวเซอร์ VirtualBox
- Windows
- ระบบปฏิบัติการที่อิงตาม Hardened Debian
- คำศัพท์ (โฮสต์, เครื่องเสมือน, ระบบปฏิบัติการเกสต์ ฯลฯ)
Hardened Debian ได้รับการกำหนดค่าด้วยฟีเจอร์ด้านความปลอดภัยขั้นสูงมากมายโดยค่าเริ่มต้น ซึ่งช่วยลดความจำเป็นที่ผู้ใช้จะต้องคลำหาการกำหนดค่าที่ซับซ้อน เราจะแสดงรายละเอียดการปรับปรุงด้านความปลอดภัยทั้งหมดในตารางพร้อมคำอธิบายสั้นๆ เกี่ยวกับประโยชน์
- ติดตั้ง Haveged ไว้โดยค่าเริ่มต้นเพื่อให้เอนโทรปีดีขึ้น
- ใช้ Secure Distributed Network Time Synchronization (sdwdate) แทน NTP
- ปิดใช้งานการแสดงตัวอย่างใน Dolphin, Nautilus
- ปิดใช้งานการประทับเวลา TCP และตัวช่วยติดตามการเชื่อมต่อของ Netfilter
- open-link-confirmation
- เปิดใช้งาน Apparmor โดยค่าเริ่มต้นพร้อมโปรไฟล์
- เบราว์เซอร์ที่เสริมความปลอดภัย (Tor Browser ที่ไม่มี Tor)
เคอร์เนล Linux ที่ปรับปรุงแล้ว
สภาพแวดล้อมเดสก์ท็อป: KDE (พร้อมใช้งานใน CLI เท่านั้น)
อื่นๆ ...
เป้าหมาย 15 ก.ย. (ข้อกำหนดของระบบ ฟีเจอร์และข้อดี การออกแบบ และเป้าหมายเสร็จสมบูรณ์)
เราจะใช้หน้าคำถามที่พบบ่อยเพื่อตอบคำถามที่สมาชิกชุมชนถามบ่อย และจะเพิ่มเนื้อหาตามความจำเป็นตลอดระยะเวลาของโปรเจ็กต์
การดาวน์โหลดและการติดตั้ง Hardened Debian จะประกอบด้วยขั้นตอนต่อไปนี้
- ตารางดาวน์โหลดที่มีอิมเมจ Hardened Debian, ลายเซ็น OpenGPG, แฮช sha512 และคีย์การลงชื่อ GPG ของนักพัฒนาซอฟต์แวร์
- ยืนยันคีย์การลงชื่อของนักพัฒนาซอฟต์แวร์และอิมเมจระบบปฏิบัติการ (บทแนะนำ)
- ดาวน์โหลดและยืนยันไฮเปอร์ไวเซอร์ VirtualBox (บทแนะนำ)
- นำเข้า Hardened Debian ใน VirtualBox (บทแนะนำ)
- เริ่ม Hardened Debian
เป้าหมาย 29 ก.ย. (ดาวน์โหลดและยืนยันอิมเมจ Debian รวมถึงการติดตั้ง Debian เสร็จสมบูรณ์)
ผู้ใช้อาจไม่คุ้นเคยกับขั้นตอนที่จำเป็นในการปรับแต่งสภาพแวดล้อมเดสก์ท็อปและจัดสรรทรัพยากรระบบ เราจะบันทึกเคล็ดลับ "การกำหนดค่าอย่างรวดเร็ว" สำหรับแต่ละรายการต่อไปนี้
- การเปลี่ยนการจัดวางแป้นพิมพ์
- การจัดสรรทรัพยากรระบบเพิ่มเติม (RAM)
- เปลี่ยนความละเอียดของหน้าจอ
- ทางลัดบนเดสก์ท็อป
- ตัวจัดการสไตล์หน้าต่าง
เราจะบันทึกข้อบกพร่องและปัญหาที่พบระหว่างการทดสอบระบบปฏิบัติการและบทแนะนำอย่างชัดเจน พร้อมวิธีแก้ปัญหาและ/หรือการแก้ไข หน้านี้จะรวมถึงปัญหาที่พบบ่อยเมื่อใช้ระบบปฏิบัติการในไฮเปอร์ไวเซอร์ด้วย
- ปัญหา RAM ไม่เพียงพอ
- การกำหนดค่า BIOS ไม่ถูกต้อง (Intel VT-d, AMD-V)
- ปัญหาเกี่ยวกับการเชื่อมต่อ
เป้าหมาย 6 ต.ค. (ขั้นตอนแรกและข้อบกพร่องของ Hardened Debian เสร็จสมบูรณ์)
ผู้ใช้ใหม่อาจไม่คุ้นเคยกับเทอร์มินัล/CLI ของ Linux หากข้อมูลที่ต้องการค้นหาได้ยากหรือเข้าถึงได้ยาก ผู้ใช้จะเปิดคำขอรับการสนับสนุนโดยไม่พยายามค้นหาวิธีแก้ปัญหาด้วยตนเอง ส่วนนี้จะบันทึกคำสั่งที่ใช้กันโดยทั่วไปและไวยากรณ์คำสั่งที่ใช้งานได้จริง man แต่ละหน้าจะแสดงภาพรวมสั้นๆ ของคำสั่ง วิธีใช้ และตัวอย่างการใช้งานจริง ผู้ใช้ต้องใช้เวลาสักพักในการจดจำคำสั่งที่ต้องใช้สำหรับงานต่างๆ การทำซ้ำจะช่วยให้ผู้ใช้จดจำไวยากรณ์คำสั่งได้เมื่อเวลาผ่านไป
- เทอร์มินัล/CLI
- sudo
- เครื่องมือแก้ไขข้อความ
- โครงสร้างไดเรกทอรี
- การไปยังส่วนต่างๆ ของระบบไฟล์
- สิทธิ์ของไฟล์
- หน้าคู่มือ
- สร้างไฟล์/ไดเรกทอรี
- เบ็ดเตล็ด (ls, cat, less)
เป้าหมาย 22 ต.ค. (พื้นที่การเรียนรู้และหน้าคู่มือเสร็จสมบูรณ์)
ผู้ใช้ Linux ที่มีความสามารถ/มีประสบการณ์จะมีทักษะการแก้ปัญหาที่ดีซึ่งได้มาเมื่อเวลาผ่านไป เมื่อเกิดปัญหา ผู้ใช้เหล่านี้จะเริ่มค้นหาวิธีแก้ปัญหาโดยอัตโนมัติ และค้นหาต่อไปจนกว่าจะพบคำตอบหรือใช้แหล่งข้อมูลที่เป็นไปได้ทั้งหมดแล้ว เมื่อผู้ใช้ Linux ใหม่พบปัญหา ผู้ใช้จะเปิดคำขอรับการสนับสนุนโดยอัตโนมัติ จึงจำเป็นอย่างยิ่งที่จะต้องเสริมสร้างแนวทางปฏิบัติที่ดีตั้งแต่เริ่มต้น
เทมเพลตการแก้ปัญหา : ผู้ใช้มีแนวโน้มที่จะแก้ปัญหาได้สำเร็จมากขึ้นหากทำตามวิธีการทีละขั้นตอน ส่วนนี้จะเน้นที่วิธีรวบรวมข้อมูลที่เกี่ยวข้องและวิธีใช้ข้อมูลดังกล่าวเพื่อค้นหาวิธีแก้ปัญหา ซึ่งจะมีลักษณะคล้ายกับส่วนก่อนหน้า
การตรวจสอบไฟล์บันทึก: ตำแหน่งของบันทึกระบบ (วัตถุประสงค์การใช้งานของบันทึกแต่ละรายการ) และคำสั่งที่จำเป็นในการจำกัดเอาต์พุต CLI (journalctl, dmesg ฯลฯ)
systemd: สถานะ การเริ่มและการหยุดบริการ
การแก้ปัญหาที่พบบ่อย: ปัญหาเกี่ยวกับการเชื่อมต่อ แพ็กเกจซอฟต์แวร์เสียหาย ฯลฯ
หลักเกณฑ์การรายงานข้อบกพร่องและ/หรือปัญหา
เป้าหมาย 5 พ.ย. (พื้นที่การเรียนรู้และการแก้ปัญหาเสร็จสมบูรณ์)
ช่วงเวลาที่เหลือของ Summer of Docs จะเน้นที่การปรับโครงสร้างเอกสาร Whonix สำหรับ Hardened Debian และการควบคุมคุณภาพ
ปรับโครงสร้างเอกสาร Whonix เพื่อใช้กับ Hardened Debian
- ติดตั้งซอฟต์แวร์อย่างปลอดภัย
- การอัปเดตระบบปฏิบัติการ