a

2026-07-03 16:58:28 +08:00
commit 32b43f85bd
6240 changed files with 1987678 additions and 0 deletions
@@ -0,0 +1,80 @@
+---
+name: systemd-vite-dev-service
+description: Configure systemd service for Vite development server with external network exposure. Use when setting up persistent Vite dev servers that need to survive SSH disconnections and accept connections from external IPs.
+---
+
+# Systemd Vite Dev Service
+
+Configure Vite development server as a systemd service for persistent, externally-accessible development environments.
+
+## When to Use
+
+- Setting up Vite dev server that persists after SSH disconnect
+- Need external access to dev server (not just localhost)
+- Creating standardized development environment across reboots
+- Managing multiple frontend projects with systemd
+
+## Key Configuration
+
+### ExecStart Pattern
+
+```ini
+ExecStart=/bin/bash -c "cd /path/to/project && npm run dev -- --host 0.0.0.0 --port <PORT>"
+```
+
+Required flags:
+- `--host 0.0.0.0` - Bind to all interfaces (external access)
+- `--port <PORT>` - Explicit port assignment
+
+### Service File Template
+
+```ini
+[Unit]
+Description=Project Frontend Dev Server
+After=network.target
+
+[Service]
+Type=simple
+User=ubuntu
+WorkingDirectory=/home/ubuntu/nanocode/project
+Environment=NODE_ENV=development
+ExecStart=/bin/bash -c "cd /home/ubuntu/nanocode/project && npm run dev -- --host 0.0.0.0 --port 10002"
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=multi-user.target
+```
+
+## Commands
+
+```bash
+# Install and start
+sudo cp project-frontend.service /etc/systemd/system/
+sudo systemctl daemon-reload
+sudo systemctl enable project-frontend
+sudo systemctl start project-frontend
+
+# Check status
+sudo systemctl status project-frontend
+sudo journalctl -u project-frontend -f
+
+# Restart after code changes
+sudo systemctl restart project-frontend
+```
+
+## Port Planning Reference
+
+| Project | Frontend Port | Backend Port |
+|---------|--------------|--------------|
+| Feidian Health | 10002 | 10003 |
+| fumamxCRM | 10000 | 10001 |
+| personal-blog | 8888 | 8889 |
+
+## Output Format
+
+Provide:
+1. Complete `.service` file content
+2. Installation commands
+3. Verification commands (status + journalctl)
+4. Port conflict check command: `sudo netstat -tlnp | grep <PORT>`