username/s5p
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: document data volume mount and container profiling

Browse Source 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
user
2026-02-15 17:05:51 +01:00
parent 11b2bdcb4f
commit 076213a830
4 changed files with 14 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
PROJECT.md
View File

@@ -33,7 +33,8 @@ Client -------> s5p -------> Hop 1 -------> Hop 2 -------> Target
| Local venv | `pip install -e .` then `s5p -c config/s5p.yaml` | | Local venv | `pip install -e .` then `s5p -c config/s5p.yaml` |
| Container | `make build && make up` (Alpine, ~59MB) | | Container | `make build && make up` (Alpine, ~59MB) |
Container mounts `./src` and `./config/s5p.yaml` read-only at runtime. Container mounts `./src` and `./config/s5p.yaml` read-only, plus
`~/.cache/s5p` as `/data` for pool state and profile output.
No application code is baked into the image. No application code is baked into the image.
## Dependencies ## Dependencies

3
README.md
View File

@@ -50,7 +50,8 @@ make logs # podman-compose logs -f
make down # podman-compose down make down # podman-compose down
``` ```
Source and config are bind-mounted, not baked into the image. Source, config, and data are bind-mounted, not baked into the image.
Pool state and profile output persist in `~/.cache/s5p/` (`/data` inside container).
## Configuration ## Configuration

4
docs/CHEATSHEET.md
View File

@@ -26,6 +26,8 @@ make logs # podman-compose logs -f
make down # podman-compose down make down # podman-compose down
``` ```
Volumes: `./src` (ro), `./config/s5p.yaml` (ro), `~/.cache/s5p` → `/data` (pool state + profiles)
## Config ## Config
```bash ```bash
@@ -92,7 +94,9 @@ curl --max-time 30 -x socks5h://127.0.0.1:1080 https://example.com
## Profiling ## Profiling
```bash ```bash
# Enable in compose.yaml: uncomment the command line
python -m pstats s5p.prof # interactive stats viewer python -m pstats s5p.prof # interactive stats viewer
python -m pstats ~/.cache/s5p/s5p.prof # container profile output
``` ```
## Metrics Log ## Metrics Log

7
docs/USAGE.md
View File

@@ -84,7 +84,8 @@ make down # stop and remove container
``` ```
Source (`./src`) and config (`./config/s5p.yaml`) are mounted read-only Source (`./src`) and config (`./config/s5p.yaml`) are mounted read-only
into the container. Edit locally, restart to pick up changes. into the container. `~/.cache/s5p` is mounted as `/data` for pool state
and profile output. Edit locally, restart to pick up changes.
## Proxy Pool ## Proxy Pool
@@ -281,6 +282,10 @@ s5p --cprofile -c config/s5p.yaml
# Custom output file # Custom output file
s5p --cprofile output.prof -c config/s5p.yaml s5p --cprofile output.prof -c config/s5p.yaml
# Container: uncomment the command line in compose.yaml
# command: ["-c", "/app/config/s5p.yaml", "--cprofile", "/data/s5p.prof"]
# Profile output persists at ~/.cache/s5p/s5p.prof on the host.
# Analyze after stopping # Analyze after stopping
python -m pstats s5p.prof python -m pstats s5p.prof
``` ```