【2026年版】Xserver VPS + Dockerで個人開発環境を構築する

ssh root@YOUR_SERVER_IP

apt update && apt upgrade -y

# ユーザー作成（例: devuser）
adduser devuser
 
# sudoグループに追加
usermod -aG sudo devuser
 
# ユーザーに切り替えて確認
su - devuser
sudo whoami  # "root" と表示されればOK

ssh-keygen -t ed25519 -C "your-email@example.com"
# パスフレーズを設定する（推奨）

ssh-copy-id devuser@YOUR_SERVER_IP
# または手動で ~/.ssh/authorized_keys に追記する

sudo nano /etc/ssh/sshd_config

PermitRootLogin no          # rootログインを無効化
PasswordAuthentication no   # パスワード認証を無効化
PubkeyAuthentication yes    # 鍵認証を有効化

sudo systemctl restart sshd

# UFWインストール（Ubuntuには最初から入っている場合が多い）
sudo apt install ufw -y
 
# デフォルトポリシーの設定
sudo ufw default deny incoming
sudo ufw default allow outgoing
 
# 必要なポートを開放
sudo ufw allow ssh      # SSHポート（22番）
sudo ufw allow 80/tcp   # HTTP
sudo ufw allow 443/tcp  # HTTPS
 
# UFWを有効化
sudo ufw enable
 
# 設定確認
sudo ufw status verbose

# 必要なパッケージのインストール
sudo apt install ca-certificates curl gnupg -y
 
# GPGキーの追加
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
  sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
 
# リポジトリの追加
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
 
# バージョン確認
docker --version
docker compose version

sudo usermod -aG docker devuser
 
# 反映のため一度ログアウト・再ログイン
exit
ssh devuser@YOUR_SERVER_IP
 
# 確認
docker ps

docker run hello-world

~/myapp/
├── docker-compose.yml
├── nginx/
│   └── default.conf
├── app/          # Next.jsアプリ
│   ├── Dockerfile
│   └── ...
└── .env

version: '3.9'
 
services:
  app:
    build:
      context: ./app
      dockerfile: Dockerfile
    environment:
      - DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD}@db:5432/myapp
      - NODE_ENV=production
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped
 
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: myapp
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: unless-stopped
 
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
      - /etc/letsencrypt:/etc/letsencrypt:ro
    depends_on:
      - app
    restart: unless-stopped
 
volumes:
  postgres_data:

FROM node:20-alpine AS base
 
# 依存関係のインストール
FROM base AS deps
RUN apk add --no-cache libc6-compat
WORKDIR /app
COPY package.json pnpm-lock.yaml* ./
RUN corepack enable pnpm && pnpm install --frozen-lockfile
 
# ビルド
FROM base AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN corepack enable pnpm && pnpm build
 
# 本番イメージ
FROM base AS runner
WORKDIR /app
ENV NODE_ENV=production
 
RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs
 
COPY --from=builder /app/public ./public
COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
 
USER nextjs
EXPOSE 3000
ENV PORT=3000
ENV HOSTNAME="0.0.0.0"
 
CMD ["node", "server.js"]

server {
    listen 80;
    server_name your-domain.com;
 
    # HTTPSへリダイレクト
    return 301 https://$host$request_uri;
}
 
server {
    listen 443 ssl;
    server_name your-domain.com;
 
    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
 
    location / {
        proxy_pass http://app:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header 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_cache_bypass $http_upgrade;
    }
}

sudo apt install certbot -y
 
# Nginxが80番を使っている場合は一時停止
docker compose stop nginx
 
# 証明書の発行
sudo certbot certonly --standalone -d your-domain.com
 
# Nginxを再起動
docker compose start nginx

sudo crontab -e
 
# 以下を追記（毎月1日の3:30に更新チェック）
30 3 1 * * certbot renew --quiet && docker compose -f /home/devuser/myapp/docker-compose.yml restart nginx

ssh-keygen -t ed25519 -f ~/.ssh/deploy_key -N ""
cat ~/.ssh/deploy_key.pub >> ~/.ssh/authorized_keys
cat ~/.ssh/deploy_key  # 秘密鍵をコピーしてGitHub Secretsに登録

name: Deploy to VPS
 
on:
  push:
    branches: [main]
 
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to VPS via SSH
        uses: appleboy/ssh-action@v1
        with:
          host: ${{ secrets.VPS_HOST }}
          username: ${{ secrets.VPS_USER }}
          key: ${{ secrets.VPS_KEY }}
          script: |
            cd ~/myapp
            git pull origin main
            docker compose build app
            docker compose up -d
            docker image prune -f

# 全コンテナのログを追跡
docker compose logs -f
 
# 特定コンテナのログのみ
docker compose logs -f app
 
# 最新100行のみ表示
docker compose logs --tail=100 app

# 停止中コンテナ・未使用イメージ・キャッシュを削除
docker system prune -f
 
# ボリュームも含めて削除（注意: データが消える）
docker system prune -f --volumes

# コンテナ別リソース使用量をリアルタイム表示
docker stats
 
# サーバー全体の負荷確認
htop

docker compose exec db pg_dump -U postgres myapp > backup_$(date +%Y%m%d).sql

# 毎日午前2時にバックアップ
0 2 * * * cd ~/myapp && docker compose exec -T db pg_dump -U postgres myapp > ~/backups/backup_$(date +\%Y\%m\%d).sql