Table of Contents
[Open][Close]

아래 글의 내용 중 casaos 설치 방법 – 우분투 초기 설정 기준 입니다.

#auto
casaos 기반 나스 우분투 설정가이드 – 마니의 블로그
우분투에 casaos를 설치하여 나스처럼 사용하는 가이드 입니다. 설치 부터 nginx 설정까지 처음 부터 상세히 적고 순서대로 차근 차근 따라오게끔 작성하였습니다. casaos는 설치도 쉬워 따라하기 쉽습니다.

CasaOS 설치

CasaOS는 간편한 홈 서버 운영체제로, Docker를 기반으로 다양한 애플리케이션과 개인 클라우드를 쉽게 관리할 수 있는 오픈소스 플랫폼입니다. 직관적인 UI로 초보자도 간단히 설치하고 사용할 수 있습니다.

#display

CasaOS 설치 명령어

설치 방법은 너무 간단합니다. 아래 명령어를 입력하면 자동으로 설치됩니다.

전 우분투 설치하자마자 바로 casaos 설치 하였습니다.

curl -fsSL https://get.casaos.io | sudo bash

같이 설치되는 프로그램들

다음과 같은 종속성 프로그램들이 함께 설치됩니다. 추 후 중복되는건 설치 할 필요가 없겠습니다.

많이 설치하는 samaba, cifs-utils, docker(docker compose), rclone 따로 설치 할 필요가 없다는거죠

필수 시스템 패키지들:

  • wget: 파일 다운로드 도구
  • curl: 데이터 전송 도구
  • smartmontools: 저장장치 모니터링 도구
  • parted: 디스크 파티션 도구
  • ntfs-3g: NTFS 파일시스템 지원
  • net-tools: 네트워크 도구 모음
  • udevil: 외부 저장장치 자동 마운트 도구
  • samba: 파일 공유 서비스
  • cifs-utils: Windows 파일 공유 지원
  • mergerfs: 여러 저장장치를 하나로 통합
  • unzip: 압축 해제 도구

주요 컴포넌트들:

  • Docker: 컨테이너 플랫폼 (버전 20 이상 필요)
  • Rclone: 클라우드 스토리지 동기화 도구 (v1.61.1 설치)

CasaOS 설정

설치가 완료되면 아래와 같이 해당 ip로 접속하라는 안내가 나옵니다. 해당 아이피로 접속합니다.

사용자 설정 및 포트변경

설치 완료 후 3~4분 지난 후 설치한 장치의 아이피로 접속을 합니다.(기본포트 80으로 되어 있으니 그냥 아이피만 입력)

그리고 아이디와 비번을 설정 해줍니다.

접속 후 좌측 상단 설정을 클릭 후 webui 포트를 변경 해줍니다.

비공식 스토어 추가

App Store 클릭 후 아래 그림 같이 앱 더보기를 클릭 하고 아래 추가 앱스토어를 추가해줍니다.

아래 리스트별로 나와 있습니다.

https://awesome.casaos.io/content/3rd-party-app-stores/list.html

아래 두개의 스토어 정도만 추가해주셔도 됩니다.

bigbeartechworld

https://github.com/bigbeartechworld/big-bear-casaos/archive/refs/heads/master.zip

CasaOS-Coolstore

https://casaos-appstore.paodayag.dev/coolstore.zip

CasaOS 구조

기본적으로 앱 설치 시 아래의 폴더로 docker-compose.yml 파일이 생성됩니다.

/var/lib/casaos/apps/설치앱명

해당 데이터 폴더는

/DATA/AppData/설치앱명

해당 docker를 새롭게 빌드할 경우 해당 폴더를 이용하시면 되겠습니다. (n8n 같이 빌드가 필요한 경우가 있습니다.)

설치는 여기까지만 보시면 되겠습니다. nginx 설치와 cloudflare ssl/tls 설정을 마치고 아래 nginx 설정으로 넘어가시기 바랍니다.

Nginx – extras 설치와 기본 설정
Nginx extras 설치와 기본 설정 방법을 안내합니다. 패키지별 차이점, 설치 방법, 사이트별 설정(sites-available, sites-enabled)을 통해 도메인 호스팅을 설정하고, default 파일 삭제로 깔끔한 환경을 만들어보세요.

CasaOS nginx 설정

cloudflare에서 casa or casaos 라는 서브도메인을 작성 한 후 진행합니다.

아래 이미지처럼 레코드 추가 후 이름에 casa 집어넣고 콘텐츠에 아이피 입력하시면 됩니다.

casaos 같은 경우 아래와 같이 nginx 설정해주면 됩니다. (casa를 앞에 붙여 서브도메인으로 진행)

“domain.com” 을 자신의 도메인명으로 변경해주세요

sudo nano /etc/nginx/sites-available/casa.domain.com

아래 복사 붙여넣기 후 Ctrol+X 로 저장 – “domain.com” 을 자신의 도메인명으로 변경해주세요

# casa.domain.com
server {
    listen 80;
    server_name casa.domain.com;   #casa 서브도메인으로 등록했을때

    # HTTP 요청을 HTTPS로 리디렉션
    return 301 https://$host$request_uri;
}

# HTTPS 설정
server {
    listen 443 ssl;
    server_name casa.domain.com;   #casa 서브도메인으로 등록했을때

    # SSL certificates
    ssl_certificate /etc/ssl/certs/domain.com.pem;
    ssl_certificate_key /etc/ssl/private/domain.com.key;
    ssl_dhparam /etc/ssl/certs/dhparam.pem;

    # SSL settings
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;

   
    # Security headers organizr ifremae 설정
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header Content-Security-Policy "frame-ancestors 'self' https://home.domain.com" always;
    add_header Strict-Transport-Security "max-age=31536000" always;



location / {
  proxy_pass http://localhost:8007/;  #casaos 설정한 포트지정
      proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

그리고 심볼링 링크파일 생성 – “domain.com” 을 자신의 도메인명으로 변경해주세요

sudo ln -s /etc/nginx/sites-available/casa.domain.com /etc/nginx/sites-enabled/

nginx 재실행

sudo systemctl restart nginx

주소창에 해당주소 casa.domain.com을 입력하면 본인의 서버 설치된 casaos 페이지에 접속이 가능해집니다.

도움 되셨으면 따듯한 커피한잔 부탁드려요!

donaricano-btn
Subscribe

도움 되셨으면 유튜브 구독 부탁드려요!!!!

관련 글들..

홈서버관리 대시보드 organizr 설치 – nginx & php8.4 기반
우분투 나스 사용하기

홈서버관리 대시보드 organizr 설치 – nginx & php8.4 기반

마니1월 10, 20258 min read

아래글의 내용중 홈서버관리 대시보드 organizr 설치 – nginx & php8.4 기반 가이드입니다. #auto 홈서버 관리 대시보드 역활을 하는 Organizr V2 입니다. 나스에 많은 서비스와 IP와 포트를 외울 필요 없이 organizr 을 사용하여 하나의 웹페이지에 나타낼수가 있습니다. 많은 정보를 보시려면 아래…

Read More

Cloudflare SSL/TLS 적용 – 클라우드플래어 https 설정 가이드
우분투 나스 사용하기유용한 정보

Cloudflare SSL/TLS 적용 – 클라우드플래어 https 설정 가이드

마니1월 8, 20255 min read

아래 글의 내용중 Cloudflare SSL/TLS 적용 – 클라우드플래어 https 설정 가이드입니다. #auto Cloudflare SSL의 주요 장점 두 서비스의 비교 비용 관리 편의성 보안 기능 유연성 선택 기준 Cloudflare는 종합적인 웹 보안 및 성능 최적화가 필요한 경우에 적합하며, Let’s Encrypt는 단순히…

Read More

도메인 구매와 cloudflare로 이전
우분투 나스 사용하기

도메인 구매와 cloudflare로 이전

마니1월 8, 20252 min read

아래 글의 내용중 도메인 구매와 cloudflare로 이전 글입니다. #auto 도메인 저렴한게 구매하면 커피 한잔 값이라고 생각하면 되겠습니다. (저도 모으다 보니 도메인이 5개가 되었네요) 아래는 저렴하게 구매가 가능한 사이트 입니다. namesilo에서 주로 구매하고 이번에 글 작성 목적으로 namecheap에서 진행 해 봤습니다.…

Read More

Nginx – extras 설치와 기본 설정
우분투 나스 사용하기

Nginx – extras 설치와 기본 설정

마니1월 6, 20252 min read

아래글의 내용중 Nginx – extras 설치와 기본 설정입니다. #auto 도메인 호스팅할때 필요한 nginx 설치 방법 입니다. 아래는 nginx 패키지별 모듈 차이점입니다. 패키지 기본 모듈 설명 nginx – 기본 HTTP 모듈 (예: ngx_http_core_module, ngx_http_vhost_traffic_status_module 등) 기본적인 HTTP 웹 서버 기능 제공.…

Read More