# safe-box

**Repository Path**: lazycatcloud/safe-box

## Basic Information

- **Project Name**: safe-box
- **Description**: 简单的文件保险箱
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-29
- **Last Updated**: 2026-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SafeBox

SafeBox is a LazyCat app for an encrypted private folder backed by `gocryptfs`.

## Paths

- Ciphertext: `/lzcapp/document/.lzc_encrypted`
- Plain mountpoint: `/lzcapp/document/SafeBox`

The app treats `.lzc_encrypted/gocryptfs.conf` as the initialization marker and
detects unlock state by parsing `/proc/self/mountinfo`.

## Build

```sh
./scripts/build.sh
```

The build script compiles the Vue frontend, copies `web/dist` into
`server/webui/dist`, and builds a single Go binary at `lzc-output/safebox`.

## Runtime

The final Docker image is based on `debian:bookworm-slim` and installs
`gocryptfs` and `fuse3`. The LazyCat manifest declares
`PERM_DOCKER_CAP_SYS_ADMIN`; development compose override also binds
`/lzcapp/document` with shared propagation for FUSE visibility.

## API

- `GET /api/status`
- `GET /api/events`
- `POST /api/init`
- `POST /api/reinitialize`
- `POST /api/unlock`
- `POST /api/lock`
- `POST /api/change-password`
- `POST /api/import`