[{"data":1,"prerenderedAt":587},["ShallowReactive",2],{"docs-page-tutorials\u002Fminecraft\u002Fsetup-on-ubuntu":3},{"id":4,"title":5,"body":6,"category":578,"deprecated":579,"description":580,"extension":581,"meta":582,"navigation":431,"path":583,"seo":584,"stem":585,"__hash__":586},"docs\u002Fko\u002Ftutorials\u002Fminecraft\u002Fsetup-on-ubuntu.md","Ubuntu에서 마인크래프트 서버 구축하기",{"type":7,"value":8,"toc":570},"minimark",[9,13,17,22,36,44,49,71,75,149,153,266,270,273,563,566],[10,11,5],"h1",{"id":12},"ubuntu에서-마인크래프트-서버-구축하기",[14,15,16],"p",{},"이 가이드에서는 Ubuntu 운영체제에서 마인크래프트 Java 에디션 서버를 구축하는 방법을 단계별로 안내합니다.",[18,19,21],"h2",{"id":20},"_1-java-설치하기","1. Java 설치하기",[14,23,24,25,30,31,35],{},"마인크래프트 서버 버전에 맞는 Java를 설치해야 합니다. ",[26,27,29],"a",{"href":28},"\u002Ftutorials\u002Fminecraft\u002Fjava-version-compatibility","Java 버전 호환성 가이드","에서 필요한 버전을 확인한 뒤 ",[26,32,34],{"href":33},"\u002Ftutorials\u002Fminecraft\u002Finstall-guide\u002Fjava#ubuntu-%EB%B0%8F-debian-%EA%B3%84%EC%97%B4","Ubuntu 및 Debian 계열 설치 방법","을 따라 설치하세요.",[14,37,38,39,43],{},"Paper 서버에서는 그래픽 관련 라이브러리가 필요할 수 있으므로 ",[40,41,42],"code",{},"headless"," Java 패키지는 권장하지 않습니다.",[45,46,48],"h3",{"id":47},"설치된-java-버전-확인","설치된 Java 버전 확인",[50,51,56],"pre",{"className":52,"code":53,"language":54,"meta":55,"style":55},"language-bash shiki shiki-themes github-dark","java -version\n","bash","",[40,57,58],{"__ignoreMap":55},[59,60,63,67],"span",{"class":61,"line":62},"line",1,[59,64,66],{"class":65},"svObZ","java",[59,68,70],{"class":69},"sDLfK"," -version\n",[18,72,74],{"id":73},"_2-마인크래프트-서버-파일-다운로드","2. 마인크래프트 서버 파일 다운로드",[76,77,78,107],"ol",{},[79,80,81,85],"li",{},[82,83,84],"strong",{},"서버를 설치할 디렉터리 생성",[50,86,88],{"className":52,"code":87,"language":54,"meta":55,"style":55},"mkdir minecraft-server\ncd minecraft-server\n",[40,89,90,99],{"__ignoreMap":55},[59,91,92,95],{"class":61,"line":62},[59,93,94],{"class":65},"mkdir",[59,96,98],{"class":97},"sU2Wk"," minecraft-server\n",[59,100,102,105],{"class":61,"line":101},2,[59,103,104],{"class":69},"cd",[59,106,98],{"class":97},[79,108,109,112,115,116,142,144,145,148],{},[82,110,111],{},"마인크래프트 서버 다운로드",[113,114],"br",{},"마인크래프트 공식 홈페이지나 PaperMC, Spigot 등 원하는 서버 종류의 웹사이트에서 서버 파일을 다운로드합니다. PaperMC를 가장 권장합니다.",[117,118,119,132],"ul",{},[79,120,121,124,125,131],{},[82,122,123],{},"PaperMC (권장):"," ",[26,126,130],{"href":127,"rel":128},"https:\u002F\u002Fpapermc.io\u002Fdownloads",[129],"nofollow","PaperMC 다운로드 페이지","에서 원하는 버전의 서버 파일을 다운로드합니다.",[79,133,134,124,137],{},[82,135,136],{},"바닐라 (공식):",[26,138,141],{"href":139,"rel":140},"https:\u002F\u002Fwww.minecraft.net\u002Fko-kr\u002Fdownload\u002Fserver",[129],"마인크래프트 Java 에디션 서버 다운로드",[113,143],{},"Paper 다운로드 링크와 빌드 번호는 변경될 수 있습니다. 오래된 명령어를 재사용하지 말고 공식 다운로드 페이지에서 운영할 버전의 최신 안정 빌드를 받아 서버 폴더에 업로드하세요. 다운로드한 파일 이름은 ",[40,146,147],{},"server.jar","로 변경하면 이후 명령어를 그대로 사용할 수 있습니다.",[18,150,152],{"id":151},"_3-서버-실행-및-설정","3. 서버 실행 및 설정",[76,154,155,240],{},[79,156,157,160,162,163,166,167,191,205,207,208,210,211,214,215,218,219,232,234,236,237,239],{},[82,158,159],{},"최초 실행 및 EULA 동의",[113,161],{},"서버를 처음 실행하면 ",[40,164,165],{},"eula.txt"," 파일이 생성됩니다.",[50,168,170],{"className":52,"code":169,"language":54,"meta":55,"style":55},"java -Xms1G -Xmx2G -jar server.jar nogui\n",[40,171,172],{"__ignoreMap":55},[59,173,174,176,179,182,185,188],{"class":61,"line":62},[59,175,66],{"class":65},[59,177,178],{"class":69}," -Xms1G",[59,180,181],{"class":69}," -Xmx2G",[59,183,184],{"class":69}," -jar",[59,186,187],{"class":97}," server.jar",[59,189,190],{"class":97}," nogui\n",[117,192,193,199],{},[79,194,195,198],{},[40,196,197],{},"-Xms1G",": 최소 램 사용량을 1GB로 설정합니다.",[79,200,201,204],{},[40,202,203],{},"-Xmx2G",": 최대 램 사용량을 2GB로 설정합니다. 서버 규모에 맞게 조절하세요.",[113,206],{},"실행 후 ",[40,209,165],{}," 파일이 생성되면 파일을 열어 ",[40,212,213],{},"eula=false","를 ",[40,216,217],{},"eula=true","로 변경하여 EULA(최종 사용자 라이선스 계약)에 동의해야 합니다.",[50,220,222],{"className":52,"code":221,"language":54,"meta":55,"style":55},"nano eula.txt\n",[40,223,224],{"__ignoreMap":55},[59,225,226,229],{"class":61,"line":62},[59,227,228],{"class":65},"nano",[59,230,231],{"class":97}," eula.txt\n",[113,233],{},[40,235,213],{}," -> ",[40,238,217],{},"로 수정하고 저장합니다.",[79,241,242,245,247,248],{},[82,243,244],{},"서버 재실행",[113,246],{},"이제 서버를 다시 실행하면 월드가 생성되고 정상적으로 서버가 구동됩니다.",[50,249,250],{"className":52,"code":169,"language":54,"meta":55,"style":55},[40,251,252],{"__ignoreMap":55},[59,253,254,256,258,260,262,264],{"class":61,"line":62},[59,255,66],{"class":65},[59,257,178],{"class":69},[59,259,181],{"class":69},[59,261,184],{"class":69},[59,263,187],{"class":97},[59,265,190],{"class":97},[18,267,269],{"id":268},"_4-선택-서비스로-등록하여-백그라운드에서-실행하기","4. (선택) 서비스로 등록하여 백그라운드에서 실행하기",[14,271,272],{},"서버를 터미널 세션과 독립적으로 실행하고, 시스템 부팅 시 자동으로 시작되도록 서비스로 등록할 수 있습니다.",[76,274,275,361,492],{},[79,276,277,280,282,285,286,298,300,301,303,304,343,345,346],{},[82,278,279],{},"실행 스크립트 작성",[113,281],{},[40,283,284],{},"start.sh"," 같은 이름의 스크립트 파일을 만듭니다.",[50,287,289],{"className":52,"code":288,"language":54,"meta":55,"style":55},"nano start.sh\n",[40,290,291],{"__ignoreMap":55},[59,292,293,295],{"class":61,"line":62},[59,294,228],{"class":65},[59,296,297],{"class":97}," start.sh\n",[113,299],{},"파일에 다음 내용을 입력합니다. ",[40,302,147],{},"가 있는 디렉터리 경로와 Java 명령어는 자신의 환경에 맞게 수정해야 합니다.",[50,305,309],{"className":306,"code":307,"language":308,"meta":55,"style":55},"language-sh shiki shiki-themes github-dark","#!\u002Fbin\u002Fsh\ncd \u002Fhome\u002Fubuntu\u002Fminecraft-server\nexec java -Xms1G -Xmx2G -jar server.jar nogui\n","sh",[40,310,311,317,324],{"__ignoreMap":55},[59,312,313],{"class":61,"line":62},[59,314,316],{"class":315},"sAwPA","#!\u002Fbin\u002Fsh\n",[59,318,319,321],{"class":61,"line":101},[59,320,104],{"class":69},[59,322,323],{"class":97}," \u002Fhome\u002Fubuntu\u002Fminecraft-server\n",[59,325,327,330,333,335,337,339,341],{"class":61,"line":326},3,[59,328,329],{"class":69},"exec",[59,331,332],{"class":97}," java",[59,334,178],{"class":69},[59,336,181],{"class":69},[59,338,184],{"class":69},[59,340,187],{"class":97},[59,342,190],{"class":97},[113,344],{},"스크립트에 실행 권한을 부여합니다.",[50,347,349],{"className":52,"code":348,"language":54,"meta":55,"style":55},"chmod +x start.sh\n",[40,350,351],{"__ignoreMap":55},[59,352,353,356,359],{"class":61,"line":62},[59,354,355],{"class":65},"chmod",[59,357,358],{"class":97}," +x",[59,360,297],{"class":97},[79,362,363,366,368,371,372,388,300,390,393,394,393,397,393,400,403,404],{},[82,364,365],{},"Systemd 서비스 파일 생성",[113,367],{},[40,369,370],{},"\u002Fetc\u002Fsystemd\u002Fsystem\u002Fminecraft.service"," 파일을 생성합니다.",[50,373,375],{"className":52,"code":374,"language":54,"meta":55,"style":55},"sudo nano \u002Fetc\u002Fsystemd\u002Fsystem\u002Fminecraft.service\n",[40,376,377],{"__ignoreMap":55},[59,378,379,382,385],{"class":61,"line":62},[59,380,381],{"class":65},"sudo",[59,383,384],{"class":97}," nano",[59,386,387],{"class":97}," \u002Fetc\u002Fsystemd\u002Fsystem\u002Fminecraft.service\n",[113,389],{},[40,391,392],{},"User",", ",[40,395,396],{},"Group",[40,398,399],{},"WorkingDirectory",[40,401,402],{},"ExecStart"," 경로는 자신의 환경에 맞게 수정하세요.",[50,405,409],{"className":406,"code":407,"language":408,"meta":55,"style":55},"language-ini shiki shiki-themes github-dark","[Unit]\nDescription=Minecraft Server\nAfter=network.target\n\n[Service]\nUser=ubuntu\nGroup=ubuntu\nWorkingDirectory=\u002Fhome\u002Fubuntu\u002Fminecraft-server\nExecStart=\u002Fhome\u002Fubuntu\u002Fminecraft-server\u002Fstart.sh\nRestart=on-failure\nRestartSec=10\n\n[Install]\nWantedBy=multi-user.target\n","ini",[40,410,411,416,421,426,433,439,445,451,457,463,469,475,480,486],{"__ignoreMap":55},[59,412,413],{"class":61,"line":62},[59,414,415],{},"[Unit]\n",[59,417,418],{"class":61,"line":101},[59,419,420],{},"Description=Minecraft Server\n",[59,422,423],{"class":61,"line":326},[59,424,425],{},"After=network.target\n",[59,427,429],{"class":61,"line":428},4,[59,430,432],{"emptyLinePlaceholder":431},true,"\n",[59,434,436],{"class":61,"line":435},5,[59,437,438],{},"[Service]\n",[59,440,442],{"class":61,"line":441},6,[59,443,444],{},"User=ubuntu\n",[59,446,448],{"class":61,"line":447},7,[59,449,450],{},"Group=ubuntu\n",[59,452,454],{"class":61,"line":453},8,[59,455,456],{},"WorkingDirectory=\u002Fhome\u002Fubuntu\u002Fminecraft-server\n",[59,458,460],{"class":61,"line":459},9,[59,461,462],{},"ExecStart=\u002Fhome\u002Fubuntu\u002Fminecraft-server\u002Fstart.sh\n",[59,464,466],{"class":61,"line":465},10,[59,467,468],{},"Restart=on-failure\n",[59,470,472],{"class":61,"line":471},11,[59,473,474],{},"RestartSec=10\n",[59,476,478],{"class":61,"line":477},12,[59,479,432],{"emptyLinePlaceholder":431},[59,481,483],{"class":61,"line":482},13,[59,484,485],{},"[Install]\n",[59,487,489],{"class":61,"line":488},14,[59,490,491],{},"WantedBy=multi-user.target\n",[79,493,494,497,541,543,546],{},[82,495,496],{},"서비스 활성화 및 시작",[50,498,500],{"className":52,"code":499,"language":54,"meta":55,"style":55},"sudo systemctl daemon-reload\nsudo systemctl enable minecraft.service # 부팅 시 자동 시작 활성화\nsudo systemctl start minecraft.service  # 서비스 시작\n",[40,501,502,512,527],{"__ignoreMap":55},[59,503,504,506,509],{"class":61,"line":62},[59,505,381],{"class":65},[59,507,508],{"class":97}," systemctl",[59,510,511],{"class":97}," daemon-reload\n",[59,513,514,516,518,521,524],{"class":61,"line":101},[59,515,381],{"class":65},[59,517,508],{"class":97},[59,519,520],{"class":97}," enable",[59,522,523],{"class":97}," minecraft.service",[59,525,526],{"class":315}," # 부팅 시 자동 시작 활성화\n",[59,528,529,531,533,536,538],{"class":61,"line":326},[59,530,381],{"class":65},[59,532,508],{"class":97},[59,534,535],{"class":97}," start",[59,537,523],{"class":97},[59,539,540],{"class":315},"  # 서비스 시작\n",[113,542],{},[82,544,545],{},"서비스 상태 확인:",[50,547,549],{"className":52,"code":548,"language":54,"meta":55,"style":55},"sudo systemctl status minecraft.service\n",[40,550,551],{"__ignoreMap":55},[59,552,553,555,557,560],{"class":61,"line":62},[59,554,381],{"class":65},[59,556,508],{"class":97},[59,558,559],{"class":97}," status",[59,561,562],{"class":97}," minecraft.service\n",[14,564,565],{},"이제 마인크래프트 서버가 Ubuntu 시스템에서 안정적으로 운영될 것입니다.",[567,568,569],"style",{},"html pre.shiki code .svObZ, html code.shiki .svObZ{--shiki-default:#B392F0}html pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sU2Wk, html code.shiki .sU2Wk{--shiki-default:#9ECBFF}html pre.shiki code .sAwPA, html code.shiki .sAwPA{--shiki-default:#6A737D}",{"title":55,"searchDepth":101,"depth":101,"links":571},[572,575,576,577],{"id":20,"depth":101,"text":21,"children":573},[574],{"id":47,"depth":326,"text":48},{"id":73,"depth":101,"text":74},{"id":151,"depth":101,"text":152},{"id":268,"depth":101,"text":269},"Stella IT Console\u002FMinecraft",false,"Ubuntu 환경에서 마인크래프트 서버를 설치하고 설정하는 방법을 알아봅니다.","md",{},"\u002Fko\u002Ftutorials\u002Fminecraft\u002Fsetup-on-ubuntu",{"title":5,"description":580},"ko\u002Ftutorials\u002Fminecraft\u002Fsetup-on-ubuntu","J_0XuXMjyZN6zS98sOn8iPZzQuQoq58jMGBah8oXi2w",1784536165184]