개발 지식 창고

시놀로지 NAS 백업, 스냅샷과 Hyper Backup 사고별로 고르기

실수로 지운 파일을 빨리 되돌리는 일은 스냅샷이 맡고, NAS 자체가 망가진 경우는 Hyper Backup으로 다른 곳에 보낸 사본이 맡습니다. 시놀로지 NAS 백업은 둘 중 하나를 고르기보다 사고 유형에 맞춰 나눠 쓰는 쪽이 맞습니다. 이 글에서는 사고 유형별 표와 설정 순서, 복원 테스트 목록까지 묶었습니다.이 글의 기준일: 2026-11-06 · 확인 환경: 공식 문서 (Snapshot Replication 규격 DSM 7.3·7.4, Hyper Backup 규격 DSM 7.2)스냅샷만 믿으면 빠지는 구멍스냅샷(특정 시점의 상태를 기록해 둔 복사본)은 공유 폴더, LUN, 이름공간의 특정 시점 복사본을 만듭니다. [1] 시놀로지는 이것을 랜섬웨어와 원치 않는 데이터 삭제에 대한 방어선으로 소개합니다..

AI 코딩 도구 설치 전 진위 확인 4단계, 공식 문서 주소부터

AI 코딩 도구는 검색 결과의 링크 대신 공식 문서 주소를 직접 열어 설치 명령을 복사하면, 검색 광고에 속을 위험을 줄일 수 있습니다. 준비물은 터미널과 공식 문서 주소 하나입니다. 이 글을 끝까지 읽으면 설치 경로별로 무엇을 확인할 수 있는지와 해시·서명을 확인하는 순서를 알게 됩니다.이 글의 기준일: 2026-11-05 · 확인 환경: 공식 문서 (Claude Code Docs 설치 안내, 2026-11-05 확인 시점)변조 설치 보도에서 확인되는 것과 안 되는 것바이낸스 보도에는 도구 이름이 없으므로, 특정 도구의 문제로 읽으면 안 됩니다. 와이드경제 보도에 따르면 바이낸스는 6월에 월렛 데브옵스 엔지니어가 AI 코딩 도구를 설치하다 변조된 프로그램을 내려받았다고 밝혔습니다. [1]같은 보도에는 ..

PostgreSQL 원격 접속 안 될 때 오류 문구별 점검 순서

PostgreSQL 원격 접속이 막히면 오류 문구부터 보면 됩니다. Connection refused는 서버 설정과 포트를 봅니다. no pg_hba.conf entry는 pg_hba.conf를, password authentication failed는 비밀번호와 인증 방식을 먼저 봅니다. 준비물은 서버 설정 파일을 고칠 권한과 psql 같은 클라이언트이며, 이 글에서는 문구별 점검 위치와 설정 반영 방식, 도커에서 막히는 지점, 열어도 되는 범위를 순서대로 다룹니다.이 글의 기준일: 2026-11-05 · 확인 환경: 공식 문서 (PostgreSQL 18 문서 current, Docker Hub postgres 이미지 페이지와 Docker Docs 확인일 2026-11-04)오류 문구 세 가지로 원인 ..

nginx 413 오류, client_max_body_size와 앞단 한도 구분법

nginx 413 오류는 기본값이 1m으로 작은 client_max_body_size부터 확인하면 됩니다. 이 값을 올리고 reload하면 되지만, 앞단에 Cloudflare가 있거나 뒤에 앱이 있으면 다른 층에서 같은 413이 날 수 있습니다. 준비물은 nginx 설정 파일 수정 권한과 터미널이고, 시간은 층 수에 따라 다르며, 결과는 막힌 층을 찾아 그 층의 한도만 고치는 것입니다.이 글의 기준일: 2026-11 · 확인 환경: 공식 문서 (nginx.org 문서와 Cloudflare Error 413 문서, 2026-11 확인)413은 어느 층에서 나는지부터 가릅니다파일 업로드 요청은 여러 층을 지나고, 413은 그중 어느 층에서든 날 수 있습니다. 한도를 올리기 전에 어느 층이 막았는지 먼저 정해..

클로드 코드 MCP 권한 규칙, mcp__ 패턴으로 허용과 차단 정하기

클로드 코드의 MCP 권한은 settings.json의 permissions에 mcp__서버__*나 mcp__서버__도구 규칙을 적어 정합니다. 준비물은 MCP 서버 하나가 연결된 프로젝트와 텍스트 편집기입니다. 끝나면 서버 단위로 허용하고 위험한 도구만 막거나 확인을 받는 상태가 됩니다.이 글의 기준일: 2026-11-05 · 확인 환경: 공식 문서 (Claude Code 권한·설정·MCP 문서, 2026-11 조회본)승인 창이 계속 뜨는 이유는 규칙 위치와 순서에 있습니다승인 창이 반복되는 가장 흔한 원인은 allow 규칙이 없거나, 있어도 ask 규칙에 밀리는 경우입니다. 공식 문서는 규칙을 deny, ask, allow 순서로 평가하고 먼저 일치한 규칙이 결과를 정한다고 설명합니다. 규칙이 더 구..

도커 컴포즈 업데이트 v5.7.0, 일반 CLI 사용자는 바꿀 것 없습니다

도커 컴포즈 v5.7.0 업데이트는 compose.yaml을 평소처럼 쓰는 사용자에게 고칠 것이 없습니다. 릴리스 노트는 CLI가 이전처럼 동작한다고 밝힙니다. 동작 변경 경고는 api.Compose를 직접 부르는 Go 라이브러리 프로그램에만 해당합니다.이 글의 기준일: 2026-11-04 · 확인 환경: 공식 문서 (Docker Compose v5.7.0 릴리스 노트, Docker Desktop 4.98.0 릴리스 노트)v5.7.0에서 바뀐 것은 라이브러리 쪽이 중심입니다v5.7.0 릴리스는 11월 2일자로 올라와 있습니다. 릴리스 페이지에 연도 표시가 없어서 날짜는 월·일로만 적습니다. [1]바뀐 내용은 세 갈래로 나뉩니다. 첫째는 Go 라이브러리 사용자에게만 영향이 있는 변경입니다. 둘째는 명령줄에..

cursorignore 설정법: 민감 파일을 Cursor AI에서 빼는 3단계

Cursor에서 민감한 파일을 AI에 보이지 않게 하려면 프로젝트 루트에 .cursorignore 파일을 만들고 .gitignore 문법으로 제외할 경로를 적습니다. 파일 하나만 만들면 되고, 준비물은 프로젝트 폴더와 텍스트 편집기뿐입니다. 이 글은 설정 방법에 더해 제외로 막히지 않는 경로와, 제외했는데도 파일이 보일 때 점검하는 순서까지 다룹니다.이 글의 기준일: 2026-11-04 · 확인 환경: 공식 문서 (Cursor Ignore files·Data Use 페이지, 2026-11-03 확인, 문서에 버전 표기 없음)외부 AI 제한 보도 이후 제외 설정을 다시 보는 이유2026-11-03 보도에 따르면 현대차그룹은 지난달 말부터 국가핵심기술을 다루는 일부 R&D 조직의 외부 AI 이용을 제한했습니..

도커 컴포즈 depends_on healthcheck로 DB 기다리게 하기

도커 컴포즈 depends_on에 condition: service_healthy를 쓰고 DB 서비스에 healthcheck(상태 점검)를 달면, 앱은 DB가 준비된 뒤에 시작합니다. 짧은 문법의 depends_on은 컨테이너가 실행되기만 기다릴 뿐 준비 여부는 보지 않기 때문입니다. 걸리는 시간은 5분 안팎이고, 준비물은 PostgreSQL 이미지와 앱 서비스가 든 compose 파일 한 개이며, 결과는 db가 healthy일 때만 app이 뜨는 구성입니다.이 글의 기준일: 2026-11-04 · 확인 환경: 공식 문서 (Docker Compose 5.x 문서, 릴리스 v5.7.0 2026-11-02 확인)DB보다 앱이 먼저 죽는 이유앱이 먼저 죽는 이유는 컨테이너가 떴다는 사실과 DB가 연결을 받는다..

CORS 오류 해결: Allow-Origin 헤더가 없을 때 점검 순서

CORS 오류는 브라우저가 서버 응답에서 Access-Control-Allow-Origin 헤더를 찾지 못했을 때 나옵니다. 서버를 직접 고칠 수 있다면 요청을 보내는 사이트의 origin(출처)을 이 헤더 값에 넣으면 해결됩니다. 이 글은 오류 문구 읽기, 단순 요청과 preflight 구분, 서버 헤더 표, no-cors가 해결책이 아닌 이유 순서로 정리합니다. [1] [2]이 글의 기준일: 2026-11 열람 · 확인 환경: 공식 문서 (MDN Web Docs, 문서에 발행일과 버전 표기 없음)준비물: 브라우저 개발자 도구, 서버 설정을 바꿀 권한 / 결과: preflight 여부와 서버에 붙일 헤더 확정콘솔 오류 문구에서 원인 찾기원인은 JavaScript 코드가 아니라 브라우저 콘솔에 적힌 문구..

ERR_REQUIRE_ESM 해결: Node 22.12 이상은 require로 불러옵니다

ERR_REQUIRE_ESM은 require()로 ES 모듈을 불러올 때 나던 오류이고, v20.19·v22.12·v23.0.0부터는 동기 모듈에서 나지 않습니다. Node 버전을 확인한 뒤 동적 import()로 바꾸면 되고, 준비물은 package.json입니다. 이 글은 파일이 CommonJS인지 ESM인지 가르는 순서와, 요즘 require()가 실패하는 대표적인 원인인 최상위 await 문제까지 다룹니다. [1] [2]이 글의 기준일: 2026-11-04 · 확인 환경: 공식 문서 (Node.js v26 최신판 문서, 버전별 이력은 각 항목에 표기)지금 이 오류가 나는 조건은 구버전 런타임입니다현재 지원 중인 Node 라인에서는 ERR_REQUIRE_ESM을 만날 일이 거의 없습니다. 공식 문서..