{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/290", "result": {"data":{"issuesJson":{"id":"ca1211b8-d9cf-5e74-a473-246c9d358263","title":"knoxite/knoxite: 一个安全的数据存储和备份系统。","number":290,"bodyHTML":"
\n



\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Reposknoxite/knoxite
Views\"views\"
Stars\"stars\"
Forks\"forks\"
License\"license\"
UpdatedAt\"last-commit\"
CreatedAt\"create-at\"
\n\n

\"\"

\n\n
\n

\"knoxite\"

\n

\"Build
\n\"Coverage
\n\"Go
\n\"GoDoc\"

\n

knoxite is a secure data storage & backup system.

\n

Join the discussion on IRC in #knoxite (on irc.libera.chat) or our Gitter chat room!

\n

🔒 It's secure

\n

knoxite uses AES-encryption to safely store your data.

\n

💪 It's flexible

\n

You can always extend your storage size or move your stored data to another machine.

\n

🚀 It's efficient

\n

knoxite cleverly de-duplicates your data before storing it and supports multiple compression algorithms.

\n

🔗 It's connected

\n

You can use multiple storage backends, even parallely: local disks, Dropbox, Amazon S3 & others.

\n

❤️ It's OpenSource

\n

knoxite is free software. Contribute and spread the word!

\n

Installation

\n

Make sure you have a working Go environment. Follow the Go install instructions.

\n

To install knoxite, simply run:

\n
git clone https://github.com/knoxite/knoxite.git\ncd knoxite\ngo build ./cmd/knoxite/\n
\n

Or use your favourite package manager:

\n
# Arch Linux (btw)\nyay -S knoxite-git\n
\n

Run knoxite --help to see a full list of options.

\n

Getting started

\n

Initialize a repository

\n

First of all we need to initialize an empty directory (in this case /tmp/knoxite) as a repository:

\n
$ knoxite -r /tmp/knoxite repo init\nEnter password:\nCreated new repository at /tmp/knoxite\n
\n

knoxite encrypts all the data in the repository with the supplied password. Be
\nwarned: if you lose this password, you won't be able to access any of your data.

\n

Initialize a volume

\n

Each repository can contain several volumes, which store our data organized in snapshots. So let's create one:

\n
$ knoxite -r /tmp/knoxite volume init \"Backups\" -d \"My system backups\"\nVolume 66e03034 (Name: Backups, Description: My system backups) created\n
\n

List all volumes

\n

Now you can get a list of all volumes stored in this repository:

\n
$ knoxite -r /tmp/knoxite volume list\nID        Name                              Description\n----------------------------------------------------------------------------------------------\n66e03034  Backups                           My system backups\n
\n

Storing data in a volume

\n

Run the following command to create a new snapshot and store your home directory in the newly created volume:

\n
$ knoxite -r /tmp/knoxite store [volume ID] $HOME -d \"Backup of all my data\"\ndocument.txt          5.69 MiB / 5.69 MiB [#########################################] 100.00%\nother.txt             4.17 MiB / 4.17 MiB [#########################################] 100.00%\n...\nSnapshot cebc1213 created: 9 files, 8 dirs, 0 symlinks, 0 errors, 1.23 GiB Original Size, 1.23 GiB Storage Size\n
\n

When errors occur while storing individual data-chunks knoxite still tries to
\ncomplete the store operation for the remaining chunks. You can toggle this
\nbehaviour to immediately exit on the first erroroneus data-chunk by setting the
\n--pedantic command line flag.

\n

List all snapshots

\n

Now you can get an overview of all snapshots stored in this volume:

\n
$ knoxite -r /tmp/knoxite snapshot list [volume ID]\nID        Date                 Original Size  Storage Size  Description\n----------------------------------------------------------------------------------------------\ncebc1213  2016-07-29 02:27:15       1.23 GiB      1.23 GiB  Backup of all my data\n----------------------------------------------------------------------------------------------\n                                    1.23 GiB      1.23 GiB\n
\n

Show the content of a snapshot

\n

Running the following command lists the entire content of a snapshot:

\n
$ knoxite -r /tmp/knoxite ls [snapshot ID]\nPerms       User   Group          Size  ModTime              Name\n----------------------------------------------------------------------------------------------\n-rw-r--r--  user   group      5.69 MiB  2016-07-29 02:06:04  document.txt\n-rw-r--r--  user   group      4.17 MiB  2016-07-29 02:05:22  other.txt\n...\n
\n

Show the content of a snapshotted file

\n

With the following command you can also print out the files content to stdout:

\n
$ knoxite -r /tmp/knoxite cat [snapshot ID] document.txt\nThis is the sample text stored in document.txt\n
\n

Restoring a snapshot

\n

To restore the latest snapshot to /tmp/myhome, run:

\n
$ knoxite -r /tmp/knoxite restore [snapshot ID] /tmp/myhome\ndocument.txt          5.69 MiB / 5.69 MiB [#########################################] 100.00%\nother.txt             4.17 MiB / 4.17 MiB [#########################################] 100.00%\n...\nRestore done: 9 files, 8 dirs, 0 symlinks, 0 errors, 1.23 GiB Original Size, 1.23 GiB Storage Size\n
\n

Cloning a snapshot

\n

Adds target file or directory to an existing snapshot:

\n
$ knoxite -r /tmp/knoxite clone [snapshot ID] $HOME\ndocument.txt          5.89 MiB / 5.89 MiB [#########################################] 100.00%\nother.txt             5.10 MiB / 5.10 MiB [#########################################] 100.00%\n...\nSnapshot aefc4591 created: 9 files, 8 dirs, 0 symlinks, 0 errors, 1.34 GiB Original Size, 1.34 GiB Storage Size\n
\n

Mounting a snapshot

\n

You can even mount a snapshot (currently read-only, read-write is work-in-progress):

\n
$ knoxite -r /tmp/knoxite mount [snapshot ID] /mnt\n
\n

Backup. No more excuses.

\n

Configuration System

\n

Knoxite comes bundled with a configuration system. You can declare shorthands
\nfor your repositories and provide default values for settings like encryption,
\ncompression or excludes. For more information refer to the documentation on our
\nwebsite or take a look into
\nthe knoxite config command.

\n

Optional environment variables

\n

Optionally you can set the KNOXITE_REPOSITORY and KNOXITE_PASSWORD environment
\nvariables to provide default settings for when no options have been passed to knoxite.

","updatedAt":"2025-05-21T16:06:09Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"Sync-Tools","color":"2f12e5"}},{"node":{"name":"knoxite","color":"d03cf6"}}]},"comments":{"edges":[]}}},"pageContext":{"number":290,"previous":{"title":"didi/KnowStreaming: 一站式云原生实时流数据平台，通过0侵入、插件化构建企业级 Kafka 服务，极大降低操作、存储和管理实时流数据门槛","number":289},"next":{"title":"moghtech/komodo: 一种在多台服务器上构建和部署软件的工具。","number":291}}}, "staticQueryHashes": ["151096407","2861350382"]}