nextcloud/server

☁️ Nextcloud server, a safe home for all your data

GitHub에서 열기 ↗ cloudcollaborationdecentralizeddesigndistributedenterprisefederationfile-sharingfree-softwarehacktoberfestjavascriptnextcloudopen-sourceopensourceowncloudphpself-hostingsharingusabilityux
36,099
GitHub 스타
5,064
포크
PHP
언어
AGPL-3.0
라이선스
2026.07.10
최근 푸시
2026.05.22
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
개인 또는 조직의 데이터를 안전하게 관리하고자 하는 사용자에게 적합하며, 특히 자체 호스팅을 선호하는 경우 강력히 추천합니다.

강점

  • 자체 호스팅이 가능하여 데이터 주권을 완전히 보장합니다.
  • 파일, 연락처, 캘린더 등 다양한 데이터를 통합 관리할 수 있습니다.
  • 수백 개의 앱으로 기능을 확장할 수 있어 유연성이 높습니다.

약점

  • 설치 및 유지보수에 어느 정도의 기술적 지식이 필요합니다.
  • 기본 포함 앱 중 일부는 수동 설치가 필요하여 초기 설정이 번거로울 수 있습니다.

주의사항

  • 프로덕션 환경에서는 `stable*` 브랜치를 사용해야 하며, `master` 브랜치는 사용하지 말아야 합니다.
  • git 서브모듈 초기화가 필요하므로 일반적인 git clone만으로는 모든 구성 요소가 준비되지 않습니다.

시작 가이드

  • 공식 문서를 참고하여 로컬 개발 환경을 설정합니다.
  • 첫 번째 기여를 위해 'good first issue' 라벨이 붙은 이슈를 선택합니다.
  • 커밋 시 서명을 잊지 말고 풀 리퀘스트를 생성합니다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

Nextcloud Server ☁

모든 데이터를 위한 안전한 공간.

왜 이렇게 멋진가요? 🤩

  • 📁 데이터에 접근하세요 파일, 연락처, 캘린더 등을 원하는 서버에 저장할 수 있습니다.
  • 🔄 데이터를 동기화하세요 파일, 연락처, 캘린더 등을 여러 기기 간에 동기화할 수 있습니다.
  • 🙌 데이터를 공유하세요 …다른 사람들이 보고 협업할 수 있도록 원하는 항목에 접근 권한을 부여할 수 있습니다.
  • 🚀 수백 개의 앱으로 확장 가능...예: Calendar, Contacts, Mail, Video Chat앱 스토어에서 찾을 수 있는 모든 앱
  • 🔒 보안 암호화 메커니즘, HackerOne 바운티 프로그램 및 2단계 인증을 제공합니다.

Nextcloud를 사용하여 집이나 조직에서 파일, 캘린더, 연락처, 커뮤니케이션 등을 어떻게 접근, 공유, 보호할 수 있는지 더 알고 싶으신가요? 모든 기능 알아보기.

Nextcloud 받기 🚚

  • ☑️ 간단히 가입하여 웹사이트나 앱을 통해 제공업체 중 하나를 이용하세요.
  • 🖥 직접 서버 설치하거나 준비된 어플라이언스 중 하나를 사용하세요.
  • 📦 Nextcloud가 사전 설치된 멋진 장치 중 하나를 구매하세요.
  • 🏢 귀하 또는 귀하의 회사를 위해 Nextcloud를 호스팅하는 서비스 제공업체를 찾으세요.

기업 사용자이신가요? 공공 부문 또는 교육 사용자이신가요? Nextcloud GmbH가 제공하는 Nextcloud Enterprise를 살펴보세요.

연락하기 💬

Nextcloud 지원도 받을 수 있습니다!

팀에 합류하세요 👪

기여 방법은 개발만이 아닙니다! 번역가, 디자이너, 테스터, 도움 제공 등 다양한 방법으로 참여하는 방법을 알아보세요! 😍

개발 환경 설정 👩‍💻

  1. 🚀 로컬 개발 환경 설정
  2. 🐛 좋은 첫 번째 이슈 선택
  3. 👩‍🔧 브랜치를 만들고 변경 사항을 적용하세요. 커밋 시 git commit -sm "Your commit message"를 사용하여 서명하는 것을 잊지 마세요.
  4. 풀 리퀘스트를 생성하고 리뷰를 위해 이슈의 사람들을 @멘션하세요.
  5. 👍 리뷰 중 발생하는 문제를 수정하세요.
  6. 🎉 병합될 때까지 기다리세요!

타사 구성 요소는 git 서브모듈로 처리되며 먼저 초기화해야 합니다. 일반적인 git 체크아웃 외에도 git submodule update --init 또는 유사한 명령이 필요합니다. 자세한 내용은 Git 문서를 참조하세요.

First run wizardActivity와 같이 일반 릴리스에 기본 포함되는 여러 앱은 master 브랜치에 없으므로 apps 하위 폴더에 클론하여 수동으로 설치해야 합니다.

그 외에는 stable* 브랜치를 사용하여 git 체크아웃을 릴리스 아카이브와 동일하게 처리할 수 있습니다. 프로덕션 시스템에서는 절대 사용하지 마세요.

코드 테스트

  • PHPUnit: PHP 단위 테스트
  • Behat: PHP 통합 테스트
  • Vitest: JavaScript/TypeScript 단위 테스트
  • Playwright: 종단간 테스트

코드의 특정 영역에 대해 여러 테스트 프레임워크를 사용합니다:

Playwright를 사용한 종단간 테스트에 대한 자세한 내용은 문서를 참조하여 오류 디버깅 및 새 테스트 케이스 기여 방법을 확인하세요.

사용하는 도구 🛠

GitHub의 유용한 봇 :robot:

  • 풀 리퀘스트에 /update-3rdparty라고 댓글을 달면 타사 서브모듈이 업데이트됩니다. PR 대상과 이름이 같은 타사 브랜치의 마지막 커밋으로 업데이트됩니다.

git blame에서 코드 스타일 업데이트 무시

git config blame.ignoreRevsFile.git-blame-ignore-revs

기여 지침 📜

2016년 6월 16일 이후 이 저장소에 대한 모든 기여는 AGPLv3 이상 버전으로 라이선스가 부여된 것으로 간주됩니다.

Nextcloud는 CLA(기여자 라이선스 동의)를 요구하지 않습니다. 저작권은 모든 개별 기여자에게 귀속됩니다. 따라서 코드에 상당한 변경을 가한 기여자는 AUTHORS 파일에 다음 줄을 추가할 것을 권장합니다:

- <이름> <이메일 주소>

행동 강령을 읽어주세요. 이 문서는 Nextcloud 참가자들이 긍정적이고 고무적인 분위기에서 효과적으로 협력하고, 서로를 강화하고 지원하는 방법을 설명합니다.

이 저장소에 기여하기 위한 지침을 검토해주세요.

기여 방법에 대한 추가 정보: https://nextcloud.com/contribute/

원본 저장소: nextcloud/server

라이선스: AGPL-3.0

게재 제외를 원하시면 삭제 요청을 보내주세요.