命令行
用法
gitea [全局选项] 命令 [命令或全局选项] [参数...]
全局选项
所有全局选项均可被放置在命令级别。
--help
,-h
:显示帮助文本并退出。可选。--version
,-v
:显示版本信息并退出。可选。 (示例:Gitea version 1.1.0+218-g7b907ed built with: bindata, sqlite
)。--custom-path path
,-C path
:Gitea 自定义文件夹的路径。可选。 (默认值:AppWorkPath
/custom 或$GITEA_CUSTOM
)。--config path
,-c path
:Gitea 配置文件的路径。可选。 (默认值:custom
/conf/app.ini)。--work-path path
,-w path
:Gitea 的AppWorkPath
。可选。 (默认值:LOCATION_OF_GITEA_BINARY 或$GITEA_WORK_DIR
)
注意:默认的 custom-path、config 和 work-path 也可以在构建时更改(如果需要)。
命令
web
启动服务器:
- 选项:
--port number
,-p number
:端口号。可选。 (默认值:3000)。覆盖配置文件中的设置。--install-port number
:运行安装页面的端口号。可选。 (默认值:3000)。覆盖配置文件中的设置。--pid path
,-P path
:Pid 文件的路径。可选。--quiet
,-q
:只在控制台上输出 Fatal 日志,用于在设置日志之前发出的日志。--verbose
:在控制台上输出跟踪日志,用于在设置日志之前发出的日志。
- 示例:
gitea web
gitea web --port 80
gitea web --config /etc/gitea.ini --pid /some/custom/gitea.pid
- 注意:
- Gitea 不应以 root 用户身份运行。要绑定到低于 1024 的端口,您可以在 Linux 上使用 setcap 命令:
sudo setcap 'cap_net_bind_service=+ep' /path/to/gitea
。每次更新 Gitea 都需要重新执行此操作。
- Gitea 不应以 root 用户身份运行。要绑定到低于 1024 的端口,您可以在 Linux 上使用 setcap 命令:
admin
管理员操作:
- 命令:
user
:list
:- 选项:
--admin
:仅列出管理员用户。可选。
- 描述:列出所有现有用户。
- 示例:
gitea admin user list
- 选项:
delete
:- 选项:
--email
:要删除的用户的电子邮件。--username
:要删除的用户的用户名。--id
:要删除的用户的ID。- 必须提供
--id
、--username
或--email
中的一个。如果提供多个,则所有条件必须匹配。
- 示例:
gitea admin user delete --id 1
- 选项:
create
:- 选项:
--name value
:用户名。必填。自 Gitea 1.9.0 版本起,请改用--username
标志。--username value
:用户名。必填。Gitea 1.9.0 新增。--password value
:密码。必填。--email value
:邮箱。必填。--admin
:如果提供此选项,将创建一个管理员用户。可选。--access-token
:如果提供,将为用户创建访问令牌。可选。(默认值:false)。--must-change-password
:如果提供,创建的用户将在初始登录后需要选择一个新密码。可选。(默认值:true)。--random-password
:如果提供,将使用随机生成的密码作为创建用户的密码。--password
的值将被忽略。可选。--random-password-length
:如果提供,将用于配置随机生成密码的长度。可选。(默认值:12)
- 示例:
gitea admin user create --username myname --password asecurepassword --email me@example.com
- 选项:
change-password
:- 选项:
--username value
,-u value
:用户名。必填。--password value
,-p value
:新密码。必填。
- 示例:
gitea admin user change-password --username myname --password asecurepassword
- 选项:
must-change-password
:- 参数:
[username...]
:需要更改密码的用户
- 选项:
--all
,-A
:强制所有用户更改密码--exclude username
,-e username
:排除给定的用户。可以多次设置。--unset
:撤销对给定用户的强制密码更改
- 参数:
regenerate
:- 选项:
hooks
:重新生成所有仓库的 Git Hooks。keys
:重新生成 authorized_keys 文件。
- 示例:
gitea admin regenerate hooks
gitea admin regenerate keys
- 选项:
auth
:list
:- 描述:列出所有存在的外部认证源。