vps-setup

majiayu000 的头像作者 majiayu000

配置全新的Ubuntu VPS用于Node.js、Python、Nginx、PM2、SSL和安全加固。适用于设置新服务器、配置网络托管、部署应用或帮助用户创建开发测试服务器。

📖 中文导读:配置全新的Ubuntu VPS用于Node.js、Python、Nginx、PM2、SSL和安全加固。适用于设置新服务器、配置网络托管、部署应用或帮助用户创建开发测试服务器。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: vps-setup description: Set up a fresh Ubuntu VPS for web development with Node.js, Python, Nginx, PM2, SSL, and security hardening. Use when setting up a new server, configuring web hosting, deploying apps, or helping users create a development playground server.

VPS Setup Skill

This skill helps set up a fresh Ubuntu VPS as a secure web development playground. It includes automated scripts and step-by-step guides for installing Node.js, Python, Nginx, PM2, Docker, SSL certificates, and security tools.

When to Use This Skill

  • Setting up a fresh VPS or cloud server
  • Configuring a development/staging environment
  • Helping users deploy their first web application
  • Setting up reverse proxy with Nginx
  • Configuring SSL certificates with Let's Encrypt
  • Hardening server security

Quick Start

For a complete automated setup, use the setup script:

# Download and run the setup script
curl -fsSL https://raw.githubusercontent.com/your-repo/vps-setup.sh | bash

Or guide users through the manual process using the reference documentation.

Architecture Overview

Internet → UFW Firewall → Nginx (80/443) → PM2 Apps (3000+)
                        ↘ Direct port access (3000-3010)

Core Components

Component Purpose Default Config
Node.js 20 LTS JavaScript runtime Via NodeSource
Python 3 Python runtime System default
PM2 Process manager Auto-restart, logging
Nginx Reverse proxy SSL termination
Certbot SSL certificates Let's Encrypt
UFW Firewall Ports 22,80,443,3000-3010
fail2ban Brute-force protection SSH jail enabled
Docker Containers Optional, available

Default Port Assignments

Port Service
22 SSH
80 HTTP (redirects to 443)
443 HTTPS
3000-3010 Development apps
5000 Internal API

Instructions for Claude

When helping a user set up a VPS:

1. Assess the Starting Point

# Check OS version
cat /etc/os-release

# Check what's already installed
which node npm python3 nginx docker pm2

# Check disk space and memory
df -h && free -h

2. Run Core Installation

Either use the automated script or guide through manual steps:

  • Update system packages
  • Install Node.js via NodeSource
  • Install PM2 globally
  • Install and configure Nginx
  • Set up UFW firewall
  • Install and configure fail2ban
  • Install Certbot for SSL

3. Create Project Structure

mkdir -p /home/projects
cd /home/projects

4. Deploy First Test App

# Create hello-world test
mkdir hello-world && cd hello-world
npm init -y
# Create simple Express server
pm2 start server.js --name hello-world

5. Configure Nginx Reverse Proxy

  • Create site config in /etc/nginx/sites-available/
  • Enable with symlink to sites-enabled/
  • Test and reload nginx

6. Set Up SSL (if domain available)

certbot --nginx -d yourdomain.com

7. Create Documentation

Generate CLAUDE.md, README.md, and QUICKSTART.md in /home/projects/

Key Commands Reference

PM2 Management

pm2 list                    # View all apps
pm2 logs [app]             # View logs
pm2 restart [app]          # Restart app
pm2 stop [app]             # Stop app
pm2 delete [app]           # Remove app
pm2 save                   # Save current apps
pm2 startup                # Enable auto-start on boot

Nginx Management

nginx -t                   # Test config
systemctl reload nginx     # Apply changes
systemctl status nginx     # Check status

Firewall Management

ufw status                 # View rules
ufw allow [port]/tcp       # Open port
ufw delete allow [port]    # Close port

SSL Certificate Management

certbot certificates       # List certs
certbot renew --dry-run   # Test renewal
certbot --nginx -d domain  # Add new cert

Security Checklist

  • UFW firewall enabled with minimal ports
  • fail2ban protecting SSH
  • SSH key authentication (recommended)
  • Regular system updates configured
  • SSL certificates installed
  • Non-root user for daily use (optional)

Troubleshooting

App not accessible

  1. Check if running: pm2 list
  2. Check logs: pm2 logs [app]
  3. Check port: lsof -i :[port]
  4. Check firewall: ufw status

SSL certificate issues

  1. Check cert status: certbot certificates
  2. Test renewal: certbot renew --dry-run
  3. Check nginx config: nginx -t

Out of memory

  1. Check usage: free -h
  2. Check processes: htop or top
  3. Consider adding swap space

Files in This Skill

  • scripts/setup.sh - Automated installation script
  • scripts/add-site.sh - Add new site helper
  • templates/nginx-site.conf - Nginx site template
  • templates/CLAUDE.md - AI assistant guide template
  • templates/README.md - Project README template
  • reference.md - Detailed step-by-step guide