taxbaik/SERVER_SETUP_GUIDE.md

서버 설정 가이드

전제

• 서버: 178.104.200.7 (Ubuntu 26.04)
• 접속: ssh kjh2064@178.104.200.7

---

Step 1: PostgreSQL 데이터베이스 생성 및 마이그레이션

서버에 SSH로 접속한 후 다음을 실행하세요:

# PostgreSQL에 접속 (로컬 unix socket, sudo 사용)
sudo -i -u postgres

# 그 다음 psql 프롬프트에서:
psql

# SQL 명령어 실행:
CREATE DATABASE taxbaikdb;
CREATE USER taxbaik WITH ENCRYPTED PASSWORD 'your_secure_password_here';
GRANT ALL PRIVILEGES ON DATABASE taxbaikdb TO taxbaik;
\q
exit

# 이제 taxbaik 사용자로 마이그레이션 실행
psql -U taxbaik -d taxbaikdb -h localhost

그러면 taxbaik=# 프롬프트가 나옵니다. 다음 SQL을 차례로 실행:

V001__InitialSchema.sql 내용 (프롬프트에 복사):

CREATE TABLE categories (
    id         SERIAL PRIMARY KEY,
    name       VARCHAR(100) NOT NULL,
    slug       VARCHAR(100) NOT NULL UNIQUE,
    sort_order INT NOT NULL DEFAULT 0
);

CREATE TABLE admin_users (
    id            SERIAL       PRIMARY KEY,
    username      VARCHAR(100) NOT NULL UNIQUE,
    password_hash VARCHAR(500) NOT NULL,
    last_login_at TIMESTAMPTZ,
    created_at    TIMESTAMPTZ  NOT NULL DEFAULT NOW()
);

CREATE TABLE blog_posts (
    id              SERIAL       PRIMARY KEY,
    title           VARCHAR(300) NOT NULL,
    content         TEXT         NOT NULL,
    slug            VARCHAR(300) NOT NULL UNIQUE,
    category_id     INT          REFERENCES categories(id) ON DELETE SET NULL,
    tags            TEXT,
    author_id       INT          REFERENCES admin_users(id) ON DELETE SET NULL,
    published_at    TIMESTAMPTZ,
    view_count      INT          NOT NULL DEFAULT 0,
    seo_title       VARCHAR(300),
    seo_description VARCHAR(500),
    thumbnail_url   VARCHAR(500),
    is_published    BOOLEAN      NOT NULL DEFAULT FALSE,
    created_at      TIMESTAMPTZ  NOT NULL DEFAULT NOW(),
    updated_at      TIMESTAMPTZ  NOT NULL DEFAULT NOW()
);

CREATE INDEX idx_blog_slug      ON blog_posts(slug);
CREATE INDEX idx_blog_published ON blog_posts(is_published, published_at DESC);
CREATE INDEX idx_blog_category  ON blog_posts(category_id);

CREATE TABLE inquiries (
    id           SERIAL       PRIMARY KEY,
    name         VARCHAR(100) NOT NULL,
    phone        VARCHAR(20)  NOT NULL,
    email        VARCHAR(200),
    service_type VARCHAR(100) NOT NULL,
    message      TEXT         NOT NULL,
    status       VARCHAR(50)  NOT NULL DEFAULT 'new',
    ip_address   VARCHAR(50),
    created_at   TIMESTAMPTZ  NOT NULL DEFAULT NOW()
);

CREATE INDEX idx_inquiry_status  ON inquiries(status);
CREATE INDEX idx_inquiry_created ON inquiries(created_at DESC);

CREATE TABLE site_settings (
    key        VARCHAR(200) PRIMARY KEY,
    value      TEXT         NOT NULL,
    updated_at TIMESTAMPTZ  NOT NULL DEFAULT NOW()
);

INSERT INTO categories (name, slug, sort_order) VALUES
    ('사업자 세무',   'business-tax',    1),
    ('부동산 세금',   'real-estate-tax', 2),
    ('종합소득세',    'income-tax',      3),
    ('부가가치세',    'vat',             4),
    ('가족자산·증여', 'family-asset',    5);

INSERT INTO site_settings (key, value) VALUES
    ('site.title',           '백원숙 세무회계 | 성북구 세무사'),
    ('site.description',     '사업자 세무, 부동산 양도세·증여세, 종합소득세 상담. 성북구 백원숙 세무사.'),
    ('kakao.channel.url',    ''),
    ('phone.main',           ''),
    ('consultation.fee.text','상담료 7만~20만 원, 계약 체결 시 일부 차감');

확인:

\dt
-- 6개 테이블 출력 (categories, admin_users, blog_posts, inquiries, site_settings, 그리고 schema_migrations)

SELECT * FROM categories;
-- 5개 카테고리 확인

\q

---

Step 2: systemd 서비스 파일 설치

로컬 컴퓨터에서 다음 파일을 서버에 복사:

# 로컬에서:
scp deploy/taxbaik.service kjh2064@178.104.200.7:~/

서버에서:

# 파일 복사
sudo cp ~/taxbaik.service /etc/systemd/system/

# 환경 변수 추가 (DB 연결 문자열)
sudo nano /etc/systemd/system/taxbaik.service
# 아래 줄을 [Service] 섹션에서 주석 해제:
# Environment=ConnectionStrings__Default=Host=localhost;Database=taxbaikdb;Username=taxbaik;Password=your_password

# systemd 재로드
sudo systemctl daemon-reload

# 서비스 활성화 (부팅 시 자동 시작)
sudo systemctl enable taxbaik

---

Step 3: Nginx 설정 추가

로컬에서 deploy/nginx-taxbaik-locations.conf 내용을 복사하여, 서버에서:

# 현재 Nginx 설정 확인
cat /etc/nginx/sites-available/default

# 또는 기존 Nginx 설정 파일 확인
ls -la /etc/nginx/sites-available/

기존 설정 파일의 http 또는 server 블록에 다음을 추가:

location /taxbaik {
    proxy_pass         http://127.0.0.1:5001;
    proxy_http_version 1.1;
    proxy_set_header   Upgrade $http_upgrade;
    proxy_set_header   Connection $connection_upgrade;
    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_read_timeout 120s;
}

설정 검증 및 재로드:

sudo nginx -t
sudo systemctl reload nginx

---

Step 4: Gitea 저장소 Secrets 추가

1. Gitea 웹UI (http://178.104.200.7/) 접속
2. kjh2064/taxbaik 저장소 이동
3. Settings → Secrets → Add Secret

다음 3개 secrets 추가:

Secret 이름	값
DEPLOY_USER	kjh2064
DEPLOY_HOST	178.104.200.7
DEPLOY_SSH_KEY	SSH 개인키 (매우 민감!)

SSH 개인키는:

# 로컬에서 (.ssh/id_rsa 또는 현재 사용 중인 키)
cat ~/.ssh/id_rsa
# 전체 내용 복사

Gitea Secret 창에 전체 붙여넣기.

---

Step 5: 배포 디렉토리 생성

서버에서:

mkdir -p ~/deployments
mkdir -p ~/taxbaik_active
# 권한 확인
ls -la ~/ | grep taxbaik

---

Step 6: 초기 배포 테스트

로컬에서:

# 솔루션 빌드
dotnet build TaxBaik.sln -c Release

# 배포는 Gitea Actions가 처리
# 수동 publish/rsync 절차는 사용하지 않음

---

Step 7: 확인 체크리스트

# 로컬에서 또는 서버에서:

# 1. DB 확인
psql -U taxbaik -d taxbaikdb -c "\dt"
# 6개 테이블 출력

# 2. 서비스 상태
sudo systemctl status taxbaik

# 3. Nginx 로그 확인
sudo tail -f /var/log/nginx/error.log

# 4. 앱 로그 확인
journalctl -u taxbaik -n 50
# 5. 엔드포인트 테스트
curl -v http://127.0.0.1:5001/health
curl -v http://127.0.0.1/taxbaik

# 6. 문의 폼 E2E 테스트
curl -X POST http://178.104.200.7/taxbaik/contact \
  -d "name=테스트&phone=010-1234-5678&service_type=기장&message=상담요청"

---

문제 해결

증상	해결
"Connection refused"	systemd 서비스 시작 안 됨: sudo systemctl start taxbaik
"Permission denied"	systemd 서비스 파일 권한 확인: sudo chmod 644 /etc/systemd/system/taxbaik.service
Nginx 404	설정 재로드: sudo nginx -t && sudo systemctl reload nginx
DB 연결 오류	환경 변수 확인: systemctl cat taxbaik | grep ConnectionStrings

---

다음 단계

서버 설정 완료 후:

• Git 저장소에 push: git push -u origin main
• 초기 블로그 포스트 5개 작성 (W6.2)
• 사이트 설정 입력 (전화번호, KakaoTalk URL)
• Lighthouse 감사 실행