이 페이지에는 Google Season of Docs에 선정된 기술 문서 작성 프로젝트의 세부정보가 포함되어 있습니다.
프로젝트 요약
- 오픈소스 조직:
- Whonix
- 기술 문서 작성자:
- 0brand
- 프로젝트 이름:
- 새로운 보안 중심 강화 Debian Linux 배포판의 설치 및 설정 문서
- 프로젝트 기간:
- 표준 기간 (3개월)
프로젝트 설명
강화 Debian은 Whonix 개발자가 활발하게 개발 중인 새로운 보안 중심 Linux 배포판입니다. 이 프로젝트에서는 Linux 배포판을 사용할 때 스스로 설 수 있는 기술을 처음 Linux를 사용하는 사용자에게 교육하는 데 중점을 두고 Windows/VirtualBox 내에서 강화 Debian을 처음부터 설치하고 설정하는 방법을 문서화합니다.
프로젝트 목표
핵심 문서 만들기
이 프로젝트의 시작 단계에서는 강화 Debian의 핵심 문서에 중점을 둡니다. 여기에는 포괄적인 프로젝트 개요, 강화 Debian을 설치하고 설정하는 튜토리얼, 설치 후 조언 및 팁이 포함됩니다.
새로운 Linux 사용자를 위한 학습 영역 만들기
새로운 Linux 사용자를 가르치는 것은 몇 개의 man 페이지를 작성하고 이를 교육 영역이라고 부르는 것이 아닙니다. 많은 초보자는 명령 프롬프트와 상호작용하고 자체 문제를 해결하는 데 익숙하지 않습니다. 이러한 페이지에서는 CLI 기술, 실제 문제 해결, 문제 해결 권장사항에 중점을 둡니다.
강화 Debian을 Whonix (익명 OS) 문서와 명확하게 구분:
Whonix.org는 Whonix와 강화 Debian을 모두 호스팅하지만 각 OS에는 매우 다른 사용 사례가 있으므로 사용자가 하나를 다른 하나로 혼동하면 심각한 결과를 초래할 수 있습니다. 예를 들어 Whonix는 익명성으로 잘 알려져 있지만 Whonix에 익숙하지 않은 신규 사용자는 강화 Debian을 설정하고 익명으로 웹을 서핑한다고 생각할 수 있습니다. 이러한 유형의 실수를 방지하기 위해 강화 Debian 문서는 Whonix OS 문서 형식 스타일과 구별되는 새로운 책과 같은 형식 스타일을 사용하여 Whonix.org의 별도 영역으로 제한됩니다. 사용자가 이러한 실수를 하지 않도록 강화 Debian 다운로드 페이지와 같은 주요 영역에 경고도 포함됩니다.
사용자 친화적인 문서
Linux 배포판의 설치 및 설정은 숙련된 사용자에게도 어려울 수 있습니다. 사용하기 쉽고 직관적인 UI는 사용자 환경을 개선할 수 있지만 명확하고 따라하기 쉬운 사용자 친화적인 문서를 작성하는 것도 마찬가지로 중요합니다. 강화 Debian 사용자층은 초보자부터 고급 Linux 사용자까지 다양하므로 기술 문서 작성자의 기술 전문 지식과 이해를 기반으로만 문서를 작성하지 않도록 주의해야 합니다. 대신 강화 Debian은 숙련된 사용자가 간단하고 쉽게 완료할 수 있는 작업을 수행하는 데 어려움을 겪을 수 있는 Linux 초보자의 관점에서 문서화됩니다.
커뮤니티 참여/기여 장려
강화 Debian은 프로젝트 기간 내내 커뮤니티가 참여하도록 보장해야만 완전히 완료할 수 있는 어려운 프로젝트입니다. 커뮤니티 회원은 의견이 열정적으로 수용되고 좋은 아이디어가 문서를 개선하는 데 사용되는 경우에만 계속 참여합니다. GSoD 전반에 걸쳐 Whonix 포럼에서 적극적으로 활동하며 문서 개선을 위한 커뮤니티 의견과 기여를 장려합니다.
강화 Debian OS 이름 바꾸기
이 운영체제는 강화 Debian을 기반으로 하지만 상표권 침해를 방지하기 위해 새 이름을 찾아야 합니다. 이 목표를 달성하기 위해 Whonix 커뮤니티는 Whonix 개발자가 선택할 수 있는 기억하기 쉬운 이름을 제출하도록 장려됩니다. 아직 브레인스토밍 모드에 있지만 가장 선호하는 두 가지는 'Sentient Linux'와 'Sentinel Linux'입니다.
프로젝트 일정
이 프로젝트의 일정은 진행 상황을 측정하고 각 섹션이 제때 완료되도록 조정할 수 있는 7개의 미니 마일스톤으로 나뉩니다. Season of Docs 중에 어려움이 발생하면 멘토에게 즉시 알려 문제를 해결하기 위한 실행 계획을 수립할 수 있도록 합니다.
9월 2일 ( Season of Docs 프로젝트 시작)
홈페이지에서는 OS의 주요 사항을 자세히 설명하는 강화 Debian의 개요를 제공합니다.
초기 문서는 Windows/VirtualBox에 강화 Debian을 설치하는 것으로 구성됩니다. 이렇게 하면 이 장의 초기 범위가 제한됩니다. 하지만 커뮤니티 회원은 Linux 호스트와 KVM 하이퍼바이저에서 강화 Debian을 테스트하고 발견 사항을 문서화하도록 장려됩니다.
지원되는 호스트 운영체제를 자세히 설명하는 표
하드웨어 요구사항을 자세히 설명하는 표
- 최소 요구사항
- 추천
- 최상의 성능
콘텐츠는 강화 Debian의 개발 목표와 용도를 자세히 설명하는 개요와 개별 구성요소를 간략하게 설명하는 표로 구성됩니다.
강화 Debian 목표.
- 보안 중심 Linux 배포판
- 무료 및 오픈소스
- 사용자 구성 가능
- 기본적으로 강화됨
강화 Debian을 구성하는 구성요소 표.
- VirtualBox 하이퍼바이저
- Windows
- 강화 Debian 기반 OS
- 용어 (호스트, 가상 머신, 게스트 OS 등)
강화 Debian은 기본적으로 많은 고급 보안 기능으로 구성되어 있습니다. 이렇게 하면 사용자가 복잡한 구성을 더듬거릴 필요가 없습니다. 모든 보안 개선사항은 이점을 간략하게 설명하는 표에 자세히 설명됩니다.
- 더 나은 엔트로피를 위해 기본적으로 Haveged가 설치되어 있습니다.
- 안전한 분산 네트워크 시간 동기화 (sdwdate)가 보험 NTP 대신 사용됩니다.
- Dolphin, Nautilus에서 미리보기를 비활성화합니다.
- TCP 타임스탬프 및 Netfilter의 연결 추적 도우미를 비활성화합니다.
- open-link-confirmation.
- 기본적으로 프로필이 사용 설정된 Apparmor.
- 보안 강화 브라우저 (Tor 없는 Tor 브라우저)
개선된 Linux 커널
데스크톱 환경: KDE (CLI에서만 사용 가능)
기타 ...
마일스톤 9월 15일 (시스템 요구사항, 기능 및 이점, 디자인 및 목표 완료)
FAQ 페이지는 커뮤니티 회원이 자주 묻는 질문에 답변하는 데 사용됩니다. 프로젝트 기간 내내 필요에 따라 콘텐츠가 추가됩니다.
강화 Debian의 다운로드 및 설치는 다음과 같이 구성됩니다.
- 강화 Debian 이미지, OpenGPG 서명, sha512 해시, 개발자 GPG 서명 키를 포함하는 다운로드 표.
- 개발자 서명 키 및 운영체제 이미지 확인 (튜토리얼).
- VirtualBox 하이퍼바이저 다운로드 및 확인 (튜토리얼).
- VirtualBox에서 강화 Debian 가져오기 (튜토리얼)
- 강화 Debian 시작
마일스톤 9월 29일 (Debian 이미지 다운로드 및 확인, Debian 설치 완료)
사용자는 데스크톱 환경을 맞춤설정하고 시스템 리소스를 할당하는 데 필요한 단계를 잘 모를 수 있습니다. 다음 각 항목에 대해 '빠른 구성' 팁이 문서화됩니다.
- 키보드 레이아웃 변경
- 추가 시스템 리소스 (RAM) 할당
- 화면 해상도 변경
- 바탕화면 바로가기
- 창 스타일 관리자
OS 및 튜토리얼 테스트 중에 발견된 버그 및 문제는 해결 방법 또는 수정사항과 함께 명확하게 문서화됩니다. 이 페이지에는 하이퍼바이저에서 운영체제를 실행할 때 발생하는 일반적인 문제도 포함됩니다.
- RAM 부족 문제
- BIOS 잘못된 구성 (Intel VT-d, AMD-V)
- 연결 문제
마일스톤 10월 6일 (첫 번째 단계, 강화 Debian 버그 완료)
새 사용자는 Linux 터미널/CLI에 익숙하지 않을 수 있습니다. 필요한 정보를 쉽게 찾거나 액세스할 수 없는 경우 해결 방법을 찾으려고 시도하지 않고 지원 요청을 열게 됩니다. 이 섹션에서는 일반적으로 사용되는 명령어와 실제 명령어 구문을 문서화합니다. 각 man은 명령어의 간략한 개요, 사용 방법, 실제 예를 제공합니다. 사용자가 다양한 작업에 사용해야 하는 명령어를 기억하는 데는 시간이 걸립니다. 반복을 통해 사용자는 시간이 지남에 따라 명령어 구문을 기억하게 됩니다.
- 터미널/CLI
- sudo
- 텍스트 편집기
- 디렉터리 구조
- 파일 시스템 탐색
- 파일 권한
- Man 페이지
- 파일/디렉터리 만들기
- 기타 (ls, cat, less)
마일스톤 10월 22일 (학습 영역, man 페이지 완료)
능숙한/숙련된 Linux 사용자는 시간이 지남에 따라 습득하는 뛰어난 문제 해결 능력을 보유하고 있습니다. 문제가 발생하면 자동으로 해결 방법을 검색하기 시작하고 답을 찾거나 가능한 모든 리소스가 소진될 때까지 계속 검색합니다. 새로운 Linux 사용자가 문제를 발견하면 자동으로 지원 요청을 엽니다. 처음부터 좋은 관행을 강화하는 것이 중요합니다.
문제 해결 템플릿 : 사용자가 단계별 안내를 따르면 문제 해결에 성공할 가능성이 높습니다. 여기에서는 관련 정보를 수집하는 방법과 이 정보를 사용하여 문제의 해결 방법을 찾는 데 중점을 둡니다. 이와 비슷합니다.
로그 파일 모니터링: 시스템 로그의 위치 (각 로그의 용도) 및 CLI 출력을 좁히는 데 필요한 명령어. (journalctl, dmesg 등)
systemd: 서비스 상태, 시작 및 중지.
일반적인 문제 해결: 연결 문제, 손상된 소프트웨어 패키지 등
버그 또는 문제 신고 가이드라인.
마일스톤 11월 5일 (학습 영역, 문제 해결 완료)
Summer of Docs의 나머지 부분은 강화 Debian용 Whonix 문서 리팩터링과 품질 관리에 중점을 둡니다.
강화 Debian과 함께 사용하도록 Whonix 문서 리팩터링
- 소프트웨어를 안전하게 설치합니다.
- 운영체제 업데이트