ownCloud/Nextcloud OCC命令行工具详解

OCC命令行工具详解

ownCloud/Nextcloud OCC命令行工具详解（1）
ownCloud/Nextcloud OCC命令行工具详解（2）
ownCloud/Nextcloud OCC命令行工具详解（3）

完整性检查

具有官方标签的插件（Apps）必须是使用拥有Nextcloud签名的代码。没有签名的官方应用程序将无法安装。对第三方插件来说，代码签名（Code Sigining）是可选的。

integrity integrity:check-app #检查使用签名的应用程序的完整性。 integrity:check-core #检查使用签名的内核的完整性 integrity:sign-app #用私玥为一个app签名 integrity:sign-core #用私玥为核心签名

创建签名密钥后，以此示例签署您的应用：

sudo -u www-data php occ integrity:sign-app --privateKey=/Users/lukasreschke/contacts.key --certificate=/Users/lukasreschke/CA/contacts.crt --path=/Users/lukasreschke/Programming/contacts

验证你的应用：

sudo -u www-data php occ integrity:check-app --path=/pathto/app appname

如果你的应用的签名是正确的，那么就不会输出任何信息。如果返回了错误信息，可以参考开发者文档中的Code Signing 获取详细信息。发布应用时要做的: 更新版本号。

integrity:sign-core

仅供Nextcloud核心开发人员使用。

了解更多：Code Signing

LDAP命令

LDAP命令只在“LDAP user and group backend” 应用激活后才能使用

只有当您启用了LDAP应用程序时，才会显示这些LDAP命令。

ldap ldap:check-user #检查一个用户是否存在于LDAP中 ldap:create-empty-config #创建一个空的LDAP配置 ldap:delete-config #删除一个LDAP配置 ldap:search #搜索用户或者组 ldap:set-config #修改LDAP配置 ldap:show-config #显示LDAP设置 ldap:show-remnants #显示那些用户在LDAP上没有信息，但是在Nextcloud中仍然存在 ldap:test-config #测试LDAP配置

使用以下语法搜索LDAP用户：

sudo -u www-data php occ ldap:search [--group] [--offset="..."]
[--limit="..."] search

搜索结果从关键词的开头开始匹配，可以看下面搜索关键词“rob”的例子：

sudo -u www-data php occ ldap:search "rob"

这样会搜索到所有以“rob”开头的词，例如robbie、roberta或robin。如果要搜索所有包含“rob”的词，可以使用通配符：

sudo -u www-data php occ ldap:search "*rob"

用户搜索属性可以用

ldap:set-config

来设置搜索属性。例如，如果将属性设置为

givenName

和

sn

，你就可以用姓+名的方式快速搜索。比如：用省略的字母

te ha

来代替全名

Terri Hanson

进行搜索。后面跟着的空格将会被省略。

检查一个LDAP用户是否存在。（只能在Nextcloud连接LDAP服务器后使用）

sudo -u www-data php occ ldap:check-user robert

当发现有的LDAP连接被禁用时，

ldap:check-user

不会运行，这是为了防止由于无法在禁用的LDAP服务器上查找该用户而误将这个用户标记为“不存在”。如果你确定所查找的用户不在已禁用的LDAP连接上，可以使用

-force

强制在所有未禁用的连接上执行搜索：

sudo -u www-data php occ ldap:check-user --force robert

ldap:create-empty-config

会创建一个空的LDAP配置。所创建的第一个配置是没有

configID

的，就像下面这样：

sudo -u www-data php occ ldap:create-empty-config Created new configuration with configID ''

在没有创建其它配置的情况下，所创建的第二个配置及之后所创建的配置会自动分配ID：

sudo -u www-data php occ ldap:create-empty-config Created new configuration with configID 's01'

接下来你可以列出你所有的配置：

sudo -u www-data php occ ldap:show-config

然后根据配置的ID来查看某一个配置:

sudo -u www-data php occ ldap:show-config s01

ldap:delete-config [configID]

可以用来删除一个存在的配置：

sudo -u www-data php occ ldap:delete s01
Deleted configuration with configID 's01'

ldap:set-config

用于操作配置，例如之前提到的设置搜索属性：

sudo -u www-data php occ ldap:set-config s01 ldapAttributesForUserSearch
"cn;givenname;sn;displayname;mail"

ldap:test-config

用于测试你的配置是否有效和能否应用到服务器上：

sudo -u www-data php occ ldap:test-config s01
The configuration is valid and the connection could be established!
#配置有效，可以建立连接！

ldap:show-remnants

可以用于清理LDAP映射表，具体可查看文档 LDAP User Cleanup。

日志命令

以下命令可用于查看或配置记录日志的首选项：

log log:manage #管理日志配置 log:owncloud #操作Nextcloud日志后端

运行

log:owncloud

可以查看你当前的日志状态：

sudo -u www-data php occ log:owncloud
Log backend Nextcloud: enabled #Nextcloud后台日志：启用
Log file: /opt/nextcloud/data/nextcloud.log #日志存放位置
Rotate at: disabled #日志轮转：禁用

使用

--enable

来启用日志。使用

--file

来修改日志存放位置。使用

--rotate-size

设置日志轮转的文件大小，0 则为禁用日志轮转。

log:manage

设置你的日志后端、日志级别和时区，默认的配置分别是

owncloud

Warning

,和

UTC

，可选的配置有

–backend [owncloud, syslog, errorlog]
–level [debug, info, warning, error]

维护模式命令

当你升级Nextcloud、配置加密、执行备份或者其它需要暂时禁止用户使用的任务时，可以使用下面的命令配置维护模式：

maintenance maintenance:data-fingerprint #备份恢复后更新系统数据指纹 maintenance:mimetype:update-db #更新数据库mimetype并刷新文件缓存 maintenance:mimetype:update-js #更新mimetypelist.js maintenance:mode #启用维护模式 maintenance:repair #修复安装 maintenance:update:htaccess #更新.htaccess文件

maintenance:mode

会锁定所有已登录的用户（包括管理员），并显示一个状态页面来提示服务器处于维护模式，未登录的用户将暂时无法登录，直到维护模式关闭。在服务器退出维护模式之后，已登录的用户必须要刷新浏览器页面后才能继续使用。

sudo -u www-data php occ maintenance:mode --on
sudo -u www-data php occ maintenance:mode --off

在重置数据备份或数据库备份后，应当先使用

maintenance:data-fingerprint

。这会改变所有文件在与同步客户端通信所用的ETag(被请求变量的实体值)，使客户端意识到文件已经被改变。

maintenance:repair

会在升级过程中自动运行以清理数据库，所以往往不需要特意运行它：

sudo -u www-data php occ maintenance:repair

maintenance:mimetype:update-db

可以根据 config/mimetypemapping.json来识别更改了mime类型的文件，并更新数据库和文件缓存。这个命令往往在修改config/mimetypemapping.json后使用。如果你动了mime类型，可以运行

maintenance:mimetype:update-db --repair-filecache

来将更改应用到存在的文件。

安全

使用这些命令来管理服务器范围的SSL证书。当您使用自签名证书的其他Nextcloud服务器创建联合共享时，这些功能很有用：

security security:certificates list trusted certificates security:certificates:import import trusted certificate security:certificates:remove remove trusted certificate

列出所有已安装的证书：

sudo -u www-data php occ security:certificates

导入一个新的证书：

sudo -u www-data php occ security:import /path/to/certificate

移除一个证书：

sudo -u www-data php occ security:remove [证书的文件名]

垃圾桶（回收站）

这个命令只在插件（应用）file_trashbin启用时可用。启用插件（应用）后，用户删除的文件将不会在服务器上立即删除

trashbin:cleanup

用于移除特定用户已删除的文件，多个用户名使用空格隔开。如果没有指定用户，则删除所有用户已删除的文件。

trashbin trashbin:cleanup 移除已删除的文件

下面是一个清理所有用户已删除的文件的例子：

sudo -u www-data php occ trashbin:cleanup
Remove all deleted files
Remove deleted files for users on backend Database freda molly stash rosa edward

下面是一个清理特定用户molly和freda的已删除文件的例子：

sudo -u www-data php occ trashbin:cleanup molly freda
Remove deleted files of molly
Remove deleted files of freda

用户管理命令

user

用于创建和删除用户、重置密码、显示一个简单的关于你有多少用户以及用户最后登录时间的报告：

user user:add #添加用户 user:delete #删除特定的用户 user:disable #禁用特定的用户 user:enable #激活特定的名号 user:lastseen #显示用户最后登录的时间 user:report #显示已有多少用户访问 user:resetpassword #为用户重置密码 user:setting #阅读或修改用户设置

你可以用display-name 、登录名和组用户关系来添加一个用户，语法为：

user:add [--password-from-env] [--display-name[="..."]] [-g|--group[="..."]]
uid

display-name 是指在浏览器中用户页面上的全名，uid是指用户的Username，即用户登录所用的账号名。例如添加一个名为Layla Smith的新用户，并将她添加至users和db-admins组，如果组不存在的话就会自动创建：

sudo -u www-data php occ user:add --display-name="Layla Smith" --group="users" --group="db-admins" layla Enter password: Confirm password: The user "layla" was created successfully Display name set to "Layla Smith" User "layla" added to group "users" User "layla" added to group "db-admins"

前往用户页面，你就会看到刚添加的新用户。

password-from-env

允许您从环境变量中设置用户密码。这样可以防止密码通过进程列表暴露给所有用户，并且只能在运行该命令的用户（root）的历史记录中显示。这也允许创建添加多个新用户的脚本。

password-from-env

要求在root账户下运行，而不是使用sudo来获取root权限。因为sudo剥离环境变量。下面是一个添加名为Fred的新用户的示例：

export OC_PASS=新密码
su -s /bin/sh www-data -c 'php occ user:add --password-from-env --display-name="Fred Jones" --group="users" fred'
The user "fred" was created successfully
Display name set to "Fred Jones"
User "fred" added to group "users"

你可以重置用户的密码，包括管理员的密码，详细内容可参考：ownCloud/Nextcloud使用OCC命令重置密码

sudo -u www-data php occ user:resetpassword layla Enter a new password: Confirm the new password: Successfully reset password for layla

你也可以使用

password-from-env

来重置用户密码：

export OC_PASS=新密码
su -s /bin/sh www-data -c 'php occ user:resetpassword --password-from-env
layla'
Successfully reset password for layla

删除用户：

sudo -u www-data php occ user:delete fred

查看用户最近的登录：

sudo -u www-data php occ user:lastseen layla layla's last login: 09.01.2015 18:46

读取用户的配置：

sudo -u www-data php occ user:setting layla - core: - lang: en - login: - lastLogin: 1465910968 - settings: - email: layla@example.tld

按插件（应用）筛选配置：

sudo -u www-data php occ user:setting layla core
- core:
- lang: en

单独获取某一项配置：

sudo -u www-data php occ user:setting layla core lang
en

修改用户配置 ? ：

sudo -u www-data php occ user:setting layla settings email "new-layla@example.tld"

删除某一项配置：

sudo -u www-data php occ user:setting layla settings email --delete

生成一个统计所有用户的简单的报告，包括外部验证用户（例如LDAP）：

sudo -u www-data php occ user:report
+------------------+----+
| User Report | |
+------------------+----+
| Database | 12 |
| LDAP | 86 |
| | |
| total users | 98 |
| | |
| user directories | 2 |
+------------------+----+

版本控制

这组命令只有在版本控制插件（应用）启用时可用

使用此命令删除特定用户的文件版本，或者在没有指定的情况下为所有用户删除文件版本：

versions versions:cleanup #删除版本

这是一个删除所有用户的版本的例子：

sudo -u www-data php occ versions:cleanup
Delete all versions
Delete versions for users on backend Database freda molly stash rosa edward

你可以为特定用户删除版本，多个用户使用空格隔开

sudo -u www-data php occ versions:cleanup freda molly
Delete versions of freda
Delete versions of molly

使用命令行工具安装Nextcloud

使用命令行安装Nextcloud

OCC命令行工具到此翻译完毕。欢迎纠错！

//首先进入occ命令目录，也就是owncloud的根目录
cd /var/www/html/owncloud

2,新增用户：

sudo -u apache php occ user:add --display-name="neo" --group="users" --group="admin" neo