diff --git a/content/ko/docs/3.for-admin/install/guides/bash.md b/content/ko/docs/3.for-admin/install/guides/bash.md index 9569ce26..86249a65 100644 --- a/content/ko/docs/3.for-admin/install/guides/bash.md +++ b/content/ko/docs/3.for-admin/install/guides/bash.md @@ -20,7 +20,9 @@ Misskey를 간단하게 설치하기 위한 쉘 스크립트가 만들어졌습 3. Cloudflare 계정 (권장) :::danger -한 번 사용한 서버의 도메인, 호스트 이름 안에선, 데이터 베이스를 다시 만들지 말아주세요! + +Let's Encrypt 인증을 할 수 있는 횟수가 적으므로, 서버의 네트워크가 DNS 설정을 확실히 확인한 후에 설치하시길 바랍니다. + ::: Let's Encrypt 인증을 할 수 있는 횟수가 적으므로, 서버의 네트워크가 DNS 설정을 확실히 확인한 후에 설치하시길 바랍니다. @@ -38,11 +40,11 @@ Cloudflare를 사용하는 경우, Cloudflare에서 도메인 설정을 끝낸 ## 조작 -### 1. SSH +### 1. 최신 환경으로 하기 서버에 SSH로 연결합니다.\ \ -(서버 화면을 직접 보고 계신 분은 터미널을 열어주세요.) +(서버 화면을 직접 보고 계신 분은 터미널을 열어주세요.) ### 2. 최신 환경으로 하기 @@ -89,7 +91,7 @@ sudo bash update.sh ### Oracle Cloud Infrastructure -이 스크립트는, Oracle Cloud Infrastructure의 Always Free 서비스로 제공되어지는 2 종류의 구성 중 어느 곳에서도 동작합니다. +iptables를 쓸 수 있게 설정하세요. - VM.Standard.E2.1.Micro (AMD) - VM.Standard.A1.Flex (ARM) [1OCPU RAM6GB or greater] @@ -102,12 +104,12 @@ iptables를 쓸 수 있게 설정하세요. 위에 적은 환경이 아닌 경우 서포트는 어려우나, 상황을 자세하게 알려주신다면 문제가 해결될 수도 있습니다. -기능 제안에 대해서도 환영하고 있습니다. - -# Tips - 선택지를 고르는 방법이나 사양에 대해서 등. +# Systemd or Docker? + +v1부터 설치 메소드에 systemd와 Docker 등을 고를 수 있게 되었습니다. + ## Systemd or Docker? v1부터 설치 메소드에 systemd와 Docker 등을 고를 수 있게 되었습니다. @@ -136,16 +138,16 @@ systemd는, Docker Hub에 이미지를 올리지는 않지만, 포크를 사용 서버 1대 위에 Misskey를 구축하는 경우, nginxfmf 사용하는 것을 추천합니다. -로드 밸런서를 설치한 경우엔 nginx를 설치하지 말고, [Misskey의 nginx 설정](../resources/nginx/)을 참고하여 로드 밸런서를 설정하는 편이 나을거라고 생각합니다. - -## Add more swaps! - 스왑을 설정하고 있는 경우, 메모리가 합쳐서 3GB 이상이지 않으면 스크립트가 움직이지 않게 되어져 있습니다. ## 한 번 실패한 뒤에 다시 스크립트를 실행하는 경우 혹시라도 한 번 실패한 상태로 다시 한 번 스크립트를 실행한 경우, 다음 내용에 주의하시길 바랍니다. +## 한 번 실패한 뒤에 다시 스크립트를 실행하는 경우 + +혹시라도 한 번 실패한 상태로 다시 한 번 스크립트를 실행한 경우, 다음 내용에 주의하시길 바랍니다. + - Redis나 Postgres의 설치가 끝난 경우, "install locally"는 No로 해야합니다.\ \ host・port 설정은 그대로 Enter를 누릅니다. @@ -157,18 +159,18 @@ systemd는, Docker Hub에 이미지를 올리지는 않지만, 포크를 사용 \ 업데이트 할 때 사용합니다. -### /root/.misskey.env +### /home/(misskey 유저)/.misskey.env misskey를 실행할 유저를 기억하기 위해 필요합니다. -### /home/(misskey 유저)/.misskey.env - -systemd인 경우에 만들어집니다.\ -\ -주로 디렉토리를 기억하는데 사용합니다. - ### /home/(misskey 유저)/.misskey-docker.env +Docker인 경우에 만들어집니다.\ +\ +실행되고 있는 컨테이너와 이미지 번호를 저장하고 있습니다. + +### 자신이 직접 관리하기 + Docker인 경우에 만들어집니다.\ \ 실행되고 있는 컨테이너와 이미지 번호를 저장하고 있습니다.\ @@ -185,7 +187,7 @@ Docker인 경우에 만들어집니다.\ Misskey 소스는 `/home/유저명/디렉토리`로 clone 되어집니다.\ \ -(유저, 디렉토리의 초기 값은 둘 다 misskey 입니다.) +(유저, 디렉토리의 초기 값은 둘 다 misskey 입니다.) Misskey 디렉토리는, 아래와 같이 이동하는 것을 추천합니다. @@ -206,40 +208,26 @@ systemd의 프로세스명은 example.com 입니다.\ \ 예를 들어서 다시 시작하려면 다음과 같이하면 됩니다. -``` -sudo systemctl restart example.com -``` - -journalctl에서 로그를 확인할 수 있습니다. - ``` journalctl -t example.com ``` 설정 파일은 `/etc/systemd/system/example.com.service`에 저장되어져 있습니다. +``` +journalctl -t example.com +``` + +Docker는 Misskey 유저에서 rootless로 실행되어져 있습니다. + ### Docker Docker는 Misskey 유저에서 rootless로 실행되어져 있습니다. -sudo에서 Misskey 유저에 로그인 할 때, `XDG_RUNTIME_DIR`과 `DOCKER_HOST`를 변경할 필요가 있습니다. +한 줄로 하고 싶을 땐 아래와 같이 하시면 됩니다. ``` -sudo -iu 유저명 -export XDG_RUNTIME_DIR=/run/user/$UID -export DOCKER_HOST=unix://$XDG_RUNTIME_DIR/docker.sock - -# 프로세스 리스트를 표시 -docker ps - -# 빌드 (리포지터리: local/misskey:latest) -docker build -t local/misskey:latest ./misskey - -# docker run -docker run -d -p 3000:3000 --add-host=docker_host:10.0.0.1 -v /home/misskey/misskey/files:/misskey/files -v "/home/misskey/misskey/.config/default.yml":/misskey/.config/default.yml:ro --restart unless-stopped -t "local/misskey:latest" - -# 로그 표시하기 -docker logs --tail 50 -f 컨테이너ID +sudo -u 유저명 XDG_RUNTIME_DIR=/run/user/$(id -u 유저명) DOCKER_HOST=unix:///run/user/$(id -u 유저명)/docker.sock docker ps ``` 한 줄로 하고 싶을 땐 아래와 같이 하시면 됩니다. @@ -248,9 +236,9 @@ docker logs --tail 50 -f 컨테이너ID sudo -u 유저명 XDG_RUNTIME_DIR=/run/user/$(id -u 유저명) DOCKER_HOST=unix:///run/user/$(id -u 유저명)/docker.sock docker ps ``` -### nginx +### Redis -nginx 설정은 `/etc/nginx/conf.d/example.com.conf`에 저장되어져 있습니다. +requirepass와 bind를 `/etc/redis/misskey.conf`로 설정하고 있습니다. ### Redis @@ -264,7 +252,7 @@ Docker에서는, 부팅 후 마이그레이션 작업을 하기 위해 바로 systemd인 경우, pnpm install에서 실패되어져 있는 경우가 있습니다. -Misskey 디렉토리에서 다음의 내용을 실행해서, 한 번 더 업데이트를 해보시길 바랍니다. +journalctl으로 로그를 확인해보면, 대부분 re2... 로 시작하는 내용이 보입니다. ``` pnpm run clean-all